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VUE GENERALE 

Introduction 



Applesoft II BASIC est le langage BASIC tres etendu de APPLE. BASIC a ete etendu car il y a 
de nombreuses caracteristiques de I'ordinateur APPLE II qui ne sont pas disponibles sur les 
autres ordinateurs qui utilisent BASIC. En ajoutant quelques nouveaux mots au langage BASIC, 
ces caracteristiques sont immediatement disponibles a quiconque utilise Applesoft. Parmi les 
caracteristiques reprises par Applesoft il y a les graphiques en couleur de APPLE, les 
graphiques couleur haute resolution et les entrees analogiques directes (les controleurs de jeu). 

Une autre caracteristique de Applesoft est ce manuel. Ce n'est pas un manuel autodidacte, 
puisque APPLE fournit un autre manuel (le manuel de programmation Applesoft II Basic qui 
vous aide a etudier la programmation meme si vous n'avez jamais touche a un ordinateur 
auparavant. Ce manuel suppose que vous savez comment programmer en BASIC et que vous 
souhaitez simplement apprendre les caracteristiques supplementaires offertes par Applesoft. Le 
chapitre 1 (commengons) est une rapide revue de ce que le langage a a offrir. Le reste du 
manuel est une description soigneuse et exacte de chaque instruction du langage et de la fagon 
dont elle est executee. Pour vous eviter la frustration et I'ennui que certains manuels peuvent 
engendrer, ce manuel attire I'attention sur les endroits ou les erreurs de programmation peuvent 
vous causer des difficultes. Des symboles speciaux attirent votre attention sur ces points. 

La methode utilisee pour decrire Applesoft est presque un langage simple en lui-meme. Apres 
un certain temps pour vous y habituer, vous trouverez qu'il accelere votre comprehension de ce 
qui est exactement legal et illegal dans te langage. Vous ne resterez pas avec des doutes qui 
vous harcelent au sujet de Interpretation d'une phase, comme cela peut se produire avec des 
descriptions uniquement faites en langue courante. 

Les programmeurs deja avances trouveront ce manuel particulierement utile. Les 
programmeurs debutants doivent savoir qu'ils ne resteront pas longtemps debutants et ils 
apprecieront I'effort supplemental fait par APPLE pour leur fournir un manuel complet (ce qui 
n'est pas habituel). Bien sur un manuel plus epais semble plus redoutable mais lorsque vous 
aurez besoin de I'information vous serez heureux que nous ayons pris le temps et la place de I'y 
mettre. 



Pour Utiliser ce manuel 



Ce manuel de reference suppose que vous disposez d'une connaissance minima de travail du 
langage de programmation BASIC. Si vous n'etes pas familiarise avec le BASIC, le manuel de 
programmation Applesoft II BASIC peut servir d'introduction: il recouvre une version du BASIC 
tres voisine de Applesoft (I mais plus simple. 

Nous vous recommandons d'avoir le Applesoft II Basic (auquel on se refere sous le nom de 
Applesoft) pret a etre utilise lorsque vous consulter Ce manuel, de fagon a pouvoir essayer sur 
votre ordinateur tout ce que ce manuel decrit ou suggere. Si Applesoft passe sur votre systeme, 
le caractere ( ] ) sera affiche. Voir appendice A pour une explication sur la fagon de charger 
Applesoft dans votre ordinateur. 

II y a deux termes que vous devez connaTtre pour lire ce manuel. Le mot "syntaxe" se rapporte a 
ta structure d'une instruction ordinateur, c'est-a-dire a I'ordre et a la forme correcte des 
differentes parties de I'instruction. Le mot "analyse" se rapporte a la fagon dont I'ordinateur 
s'efforce d'interpreter ce que vous tapez, en examinant les differentes parties des instructions 
ordinateurs pour les executer. Par exemple la synthese de Applesoft vous permet de taper: 



12x5-4*3 A 2 



Lorsque Applesoft analyse cette entree, il prend d'abord 12 comme numero de la ligne de 
programme, puis interprete X5 comme etant un nom de variable arithmetique. Enfin Applesoft 
evalue 3/2 comme valant 9, puis multiplie par 4 et affecte la valeur 36 a la variable dont le nom 
est X5. 

Le chapitre 1 donne une vue generale de plusieurs instructions Applesoft pour ceux qui n'ont 
que peu d'experience de programmation en BASIC. On introduit de nombreux concepts 
primaires en utilisant les exemples que vous pouvez taper sur votre ordinateur. L'appendice B 
attire I'attention sur certains points concernant I'edition des programmes Applesoft. 
La notation introduite au debut du chapitre 2 s'utilise pour decrire la syntaxe de Applesoft avec 
concision et sans ambiguTte. Elle vous economisera du temps et des efforts pour comprendre la 
fagon dont les instructions doivent etre structures. Vous n'avez pas besoin d'utiliser cette 
notation par vous-meme mais elle vous aidera a repondre a de nombreuses questions qui ne 
sont pas specifiquement discutees dans le texte. Par exemple les crochets ( [et] ) sont utilises 
pour indiquer les portions optionnelles d'une instruction; les accolades ( [et] ) sont utilisees pour 
indiquer les portions qui peuvent etre repetees. Par exemple 

[LET] C = 3 

indique le mot LET est optionnel et peut etre omis. Et 
REM [{character}] 

indique que I'instruction REMARK comprend le mot REM optionnellement suivi d'un ou de 
plusieurs caracteres, 

Les abreviations et les definitions syntaxiques de la premiere partie du chapitre 2 sont 
presentees dans un ordre logique pour ceux qui souhaitent voir comment nous avons bati notre 
systeme de symbole et de definitions. Vous pouvez preferer ignorer ces symboles et definitions 
jusqu'a ce que vous en rencontriez dans le texte. A ce moment la vous pouvez pour referer au 
glossaire alphabetique des termes syntaxiques donnes dans l'appendice M. 
Les chapitres 3 a 10 presentent des explications detaillees des instructions Applesoft, groupees 
par sujet. Si vous etes interesse de connaTtre une commande specifique, I'index alphabetique 
de la derniere page vous indiquera ou il faut regarder. Vous pouvez trouver dans les 
appendices des renseignements supplementaires non repris dans les differents chapitres. 
A certains endroits vous verrez le symbole: 




precedant un paragraphe. Ce symbole indique une caracteristique inhabituelle sur laquelle il 
faut attirer votre attention. 
Le symbole 




precede les paragraphes qui decrivent des situations ou il peut ne pas etre possible de 
recuperer Applesoft. Vous perdrez votre programme et vous aurez probablement a redemarrer 
Applesoft. 
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Instructions a execution immediate 



Essayez de taper ce qui suit 

PRINT 10-4 
puis enfoncer la touche marquee RETURN 

APPLESOFT va immediatement imprimer 
6 

L'instruction PRINT que vous avez tapee a ete executee des que vous avez enfonce la touche 
RETURN APPLESOFT a calcule la valeur de ta formule situee apres le 4 et a tape sa valeur, 
dans ce cas 6. 

Maintenant essayez de taper ceci: 

PRINT 1/2,3*10 
(* signifie multiplier, / signifie diviser) 

Lorsque vous enfoncez la touche RETURN APPELSOFT va imprimer 
.5 30 

Comme vous pouvez voir, APPLESOFT effectue la division et la multiplication aussi bien que la 
soustraction. Notez la fagon dont on a utilise une virgule ( , ) dans l'instruction PRINT pour 
imprimer deux valeurs au lieu d'une. L'utilisation de la virgule avec l'instruction PRINT divise la 
ligne de 40 caracteres en 3 colonnes ou "champs du tabulateur". Voir la discussion concernant 
les champs du tabulateur dans le chapitre 6 sous l'instruction PRINT. 

Instructions a execution differee 



Les instructions comme l'instruction PRINT que vous venez de taper sont appelees instructions 
a execution immediate. II y a un autre type d'instructions appelees instructions differees. 
Chaque instruction a execution differee commence par un numero de ligne. Une numero de 
ligne est un entier de a 63999. 

Essayez de taper les lignes suivantes: 
10 PRINT 2+3 
20 PRINT 2-3 

(n'oubliez pas que chaque ligne doit se terminer en enfongant la touche RETURN). 

Une suite d'instructions a execution differee s'appelle un "programme". Au lieu d'executer 
immediatement les instructions a execution differee, APPLESOFT BASIt enregistre les 
instructions a execution differee en memoire APPLE. Lorsque vous tapez RUN, APPLESOFT 
execute d'abord l'instruction enregistree en memoire dont le numero de ligne est le plus faible, 
puis l'instruction a numero de ligne le plus eleve et le plus proche, etc. . . , jusqu'a ce que tout le 
programme soit execute. 

Supposons que vous tapiez maintenant RUN (n'oubliez pas d'enfoncer la touche RETURN a la 
fin de chaque ligne tapee): 
RUN 

APPLESOFT va maintenant afficher sur votre TV: 

5 

-1 

Dans I'exemple precedent vous avez tape la ligne 10 d'abord puis la ligne 20. Toutefois I'ordre 
dans lequel vous avez tape les instructions a execution differee n'a pas d'importance. 
APPLESOFT les execute toujours dans I'ordre numerique correct en fonction de leur numero de 
ligne. 
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Pour avoir un listage du programme complet actuellement en memoire, avec les instructions 
disposees dans leur ordre correct, tapez 
LIST 

APPLESOFT va repondre par 
10 PRINT 2+3 
20 PRINT 2-3 

On souhaite parfois effacer une ligne d'un programme. Ceci s'obtient en tapant le numero de la 
ligne que Ton souhaite effacer, puis en enfongant la touche RETURN. 

Tapez ce qui suit: 
10 

LIST 

APPLESOFT va repondre par 
20 PRINT 2-3 

Vous avez done efface la ligne 10 du programme. II n'est pas possible de la faire revenir pour 
inserer une nouvelle ligne 10 il suffit de taper 10 suivi de ta nouvelle instruction que vous 
desirez faire executer par APPLESOFT. 
Tapez ce qui suit: 

10 PRINT 2*3 

LIST 

APPLESOFT va repondre par 
10 PRINT 2*3 
20 PRINT 2-3 

Ceci constitue une fagon plus facile de remplacer la ligne 10 que de I'effacer et d'inserer une 
nouvelle ligne. Vous pouvez le faire en tapant simplement la nouvelle ligne 10 (et en enfongant 
bien sur la touche RETURN). APPLESOFT enleve automatiquement I'ancienne ligne 10 et la 
remplace par la nouvelle. 

Tapez ce qui suit: 

10 PRINT 3-3 
LIST 

APPLESOFT repond par 
10 PRINT 3-3 
20 PRINT 2-3 

II n'est pas recommande de numeroter les lignes de programme a la suite: il peut etre 
necessaire plus tard d'inserer une nouvelle ligne entre deux lignes existantes. Un de 10 entre 
les numeros de lignes est generalement suffisant. 

Si vous desirez effacer la totalite du programme actuellement enregistre en memoire, tapez 
NEW 

Si vous avez fini de faire passer un programme et si vous en commencez maintenant un autre, 
commencez par taper NEW. Ceci evitera un melange de I'ancien et du nouveau programme. 
Tapez ce qui suit: 
NEW 

APPLESOFT va repondre par le caractere 
] 

Maintenant tapez 
LIST 

APPLESOFT va repondre par 

] 

ce qui indique que votre programme precedent ne se trouve plus en memoire. 
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Format des nombres 



Nous allons faire une digression pendant un moment pour expliquer le format des nombres 
imprimes par APPLESOFT BASIC. Les nombres sont enregistres en memoire interne avec une 
precision qui peut depasser 9 chiffres. Lorsqu'un nombre est imprime, il n'apparaTt que 9 chiffres 
seulement. Chaque nombre peut comporter un exposant (une puissance de dix) 

En APPLESOFT BASIC les nombres en "precision reelle" (egalement nommes 'a virgule 
flottante') doivent etre compris entre -1 * 10 A 38 et 1* 10 A 38, sinon vous risquez d'avoir un 
message d'erreur. En faisant des additions ou des soustractions vous pouvez parfois engendrer 
des nombres aussi grands que 1 .7* 10 ' 38 sans recevoir de message d'erreur. Un nombre dont 
la valeur absolue est inferieure a environ 3*10 A -39 sera converti en zero par APPLESOFT. En 
plus de ces limitations, les valeurs reelles des entiers doivent etre entre -32767 et 32767. 

Lorsqu'un nombre est imprime, on utilise les regies suivantes pour determiner son format exact. 

1. Si le nombre est negatif, un signe moins ( - ) est imprime 

2. Si la valeur absolue du nombre est un entier entre et 999999999, ce nombre est imprime 
comme entier. 

3. Si la valeur absolue du nombre est superieure ou egale a .01 et inferieure a 999999999.2, le 
nombre est imprime en notation a virgule fixe sans exposant. 

4. Si le nombre ne tombe pas dans les categories 2 ou 3, e'est la notation scientifique qui est 
utilisee. 



La notation scientifique est utilisee pour imprimer les nombres en precision reelle et son format 

est comme suit: 

SX.XXXXXXXXESTT 

ou chaque X est un entier de O a 9. 

Le S de tete est le signe du nombre, hen pour un nombre positif et signe moins ( - ) pour un 
nombre negatif. Un chiffre autre que est imprime avant le point decimal, II est suivi du point 
decimal puis des huit autres chiffres de la mantisse. Un E (pour exposant) s'imprime alors, suivi 
du signe (S) de I'exposant: puis des deux chiffres (TT) de I'exposant lui-meme. Les zeros de 
tete ne sont jamais imprimes; i.e. le chiffre avant le point decimal n'est jamais zero. De meme 
les zeros de queue ne sont jamais imprimes. 

S'il n'y a qu'un seul chiffre a imprimer apres suppression de tous les zeros de queue, on 
n'imprime pas de point decimal. Le signe de I'exposant sera plus ( + ) pour positif et moins ( - ) 
pour negatif. On imprime toujours deux chiffres de I'exposant, e'est-a-dire que les zeros ne sont 
pas supprimes dans le champ de I'exposant. 

La valeur d'un nombre exprime sous forme de notation scientifique comme decrit ci-dessus est 
le nombre qui se trouve a gauche de E multiplies par 10 eleve a ta puissance du nombre qui se 
trouve a la droite de E. 



Ci-dessous quelques exemples de differents nombres et du format de sortie que utilise pour les 
imprimer: 

FORMAT DE SORTIE 
1 

-1 

6523 
-23.46 
4572000 
1E+20 

-1 .2345679E+1 1 
1E+09 
999999999 



NOMBRE 

+1 

-1 

6523 
-23.460 
45.72E5 
1*10 A 20 

-1 2.34567896*1 A 10 

1000000000 

999999999 
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Un nombre tape au clavier ou une constante numerique utilisee dans un programme 
APPLESOFT peuvent avoir autant de chiffres que desire, jusqu'a la longueur maxima de 38 
chiffres. Toutefois seuls les dix premiers chiffres sont habituellement significatifs et le dixieme 
chiffre est arrondi: 
Par exemple si vous tapez 

PRINT 1 .23456787654321 

APPLESOFT repond par 

1 .23456788 



Exemples de graphiques couleur 



Tapez 

GR 

Ceci va effacer et rendre noir les vingt lignes superieures du texte sur votre ecran TC et ne 
laisser que quatre lignes de texte en bas. Votre APPLE se trouve maintenant en mode "Color 
Graphics" basse resolution. 
Maintenant tapez 

COLOR =13 

APPLESOFT ne va repondre que par le caractere 

] 

et le clignotement du curseur, mais a I'interieur il se souvient que vous avez choisi une couleur 
jaune. 

Maintenant tapez 

PLOT 20, 20 

APPLESOFT va repondre en tragant un petit carre jaune au centre de I'ecran. Si le carre n'est 
pas jaune, c'est que votre appareil TV n'est pas correctement regie: il faut regler les 
commandes de couleur pour obtenir un jaune citron clair. 

Maintenant tapez 

HLIN0.30 AT 20 

APPLESOFT va tirer un trait horizontal en travers du quart le plus a gauche de I'ecran, a un 
quart en dessous du haut. 

Maintenant tapez COLOR = 6 

pour avoir une nouvelle couleur puis tapez la ligne 
VLIN 10,39 AT 30 

Vous en apprendrez davantage plus tard sur "Color Graphics". Pour revenir au mode texte, 
tapez 

TEXT 

I'affichage de caracteres sur I'ecran est la fagon dont APPLE montre I'information couleur sous 
forme de texte. 

Lors de I'impression des reponses aux problemes, il est souvent souhaitable d'inclure du texte 
avec les reponses, pour expliquer la signification des nombres tapez ce qui suit: 
PRINT ONE THIRD IS EQUAL TO", 1/3 

APPLESOFT va repondre par 

ONE THIRD IS EQUAL TO .333333333 
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Format d' impression 



Comme explique precedemment, le fait d'inclure une virgule ( , ) dans une instruction PRINT 
oblige a passer jusqu'au champ de tabulateur suivant avant d'imprimer la valeur qui suit la 
virgule. Si vous utilisez un point virgule ( ; ) a la place d'une virgule, la valeur suivante sera 
imprimee immediatement a la suite de la valeur precedente. Essayez, 

PRINT 1,2,3 
1 2 3 

Essayez les exemples suivants 
PRINT 1:2;3 
123 



PRINT-1:2;-3 
-12-3 

Ce qui suit est un exemple d'un programme qui lit une valeur a partir du clavier et utilise cette 
valeur pour calculer et imprimer un resultat. 

10 INPUT R 

20 PRINT 3.14159*R*R 

RUN 

?10 

314.159 

Voici ce qui se passe. Lorsque APPLESOFT rencontre I'instruction INPUT, il affiche un point 
d'interrogation (?) sur I'ecran puis attend que vous tapiez un nombre. Lorsque vous operez, 
par exemple dans I'exempte precedent, c'est 10 qui a ete tape, la valeur tapee est affectee a la 
variable qui suit INPUT (dans ce cas on a donne a la variable R la valeur 10). Puis I'execution 
se poursuit par I'instruction suivante du programme, qui dans I'exemple precedent est la ligne 
20. Pour le calcul de la formule qui vient apres I'instruction PRINT, on remplace la variable R 
par la valeur 10 chaque fois que R apparaTt dans la formule. La formule devient done 3.14159* 
10* 10, soit.314.159. 

Si vous ne t'aviez pas deja devine, le programme ci-dessus calcule la surface d'un cercle de 
rayon R. 

Si nous desirons calculer ta surface de differents cercles, nous pourrions re executer le 
programme pour chaque cercle successif. Mais il y a une fagon plus simple de le faire, 
simplement en ajoutant une autre ligne au programme comme suit: 

30 GOTO 10 

RUN 
?10 

314.159 
?3 

28.27431 
?4.7 

69.3977231 
? 

BREAK IN 10 

] 
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En plagant une instruction GOTO a la fin de votre programme, vous I'obligez a revenir a la ligne 
10 chaque fois qu'il a imprime une reponse. Ceci pourrait se poursuivre indefiniment mais nous 
avons decide d'arreter apres avoir calcule la surface de trois cercles. Cet arret se fait en tapant 
un CONTROL C (c'est-a-dire en tapant ta lettre C tout en maintenant enfoncee la touche CTRL) 
puis en enfongant la touche RETURN. Ceci provoque une rupture dans I'execution du 
programme qui nous permet de I'arreter. En utilisant CONTROL C on peut arreter tout 
programme apres avoir execute I'instruction en cours. Essayez par vous-meme. 



Noms de variables 



La lettre R dans le programme que nous venons d'executer s'appelait une "variable". C'est 
simplement un emplacement de memoire dans I'ordinateur, identifie par le nom R. Un nom de 
variable doit commencer par un caractere alphabetique et peut etre suivi de tout caractere 
alphanumerique. Un caractere alphanumerique est toute lettre de A a Z ou tout chiffre de a 9. 

Un nom de variable peut avoir jusque 238 caracteres de long, mais APPLESOFT n'utilise que 
les deux premiers caracteres pour distinguer un nom d'un autre. Par consequent les noms 
GOOD 4 NOUGHT et GOLDRUSH se referent a la meme variable. 

Dans un nom de variable tous les caracteres alphanumeriques qui suivent les deux premiers 
sont ignores a moins qu'ils ne contiennent un "mot reserve". Certains mots utilises dans les 
instructions APPLESOFT BASIC sont "reserves' ' pour leur usage specifique. Vous ne pouvez 
pas utiliser ces mots comme noms de variable ou comme partie d'un nom de variable. Par 
exemple FEND serait illegal car END est un mot reserve. Les mots reserves de APPLESOFT 
BASIC sont repris sur une liste et discutes dans I'appendice F. 

Les noms de variable qui se terminent par un $ ou un % ont une signification speciale et on en 
discute plus loin dans ce chapitre dans le paragraphe variables reelles, entieres et chaines. 

Ci-dessous quelques exemples de noms de variable legaux et illegaux. 



LEGAL ILLEGAL 

TP. TO (les noms de variable ne peuvent pas etre des mots 

PDTG $ reserves) 

COUNT RGOTO (les noms de variable ne peuvent pas contenir 

N 1% de mots reserves). 



En plus d'affecter une valeur a une variable avec I'instruction INPUT, vous pouvez egalement 
definir la valeur d'une variable avec une instruction LET ou instruction d'affectation. 

Essayez I'exempte suivant: 
A = 5 

PRINTA, A*2 
5 10 

LET Z=7 
PRINTZ, Z-A 
7 2 

Comme on peut le voir sur ces exemples, le LET est en option dans une instruction 
d'affectation. 
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BASIC se souvient des valeurs qui ont ete affectees aux variables en utilisant ce type 
destructions. Ce processus de souvenir utilise de la place dans la memoire de APPLE pour 
enregistrer les donnees. 

Les valeurs des variables sont enlevees et I'emplacement en memoire est utilise pour les 
enregistrer et libere lorsqu'il se produit I'un des quatre evenements suivants 

1. Une nouvelle ligne est tapee dans le programme ou une ancienne ligne est effacee. 

2. Une instruction CLEAR est emise. 

3. Une instruction RUN est emise. 

4. On tape NEW. 

Voici un autre fait important: a moins que vous ne leur affectiez une autre valeur, toutes les 
variables numeriques prennent automatiquement la valeur zero. Essayez cet exemple: 

PRINT Q, Q+2, Q*2 

2 

Une autre instruction est I'instruction REM. REM est I'abreviation de remarque. Cette instruction 
s'utilise pour inserer des commentaires ou des notes dans un programme. Lorsque BASIC 
rencontre une instruction il ignore le reste de la ligne. Cette instruction sert principalement a 
aider le programmeur et non pas comme fonction utile du programme pour resoudre un 
probleme particulier. 



IF... THEN... 



Ecrivons un programme pour verifier si un nombre qui a ete tape est zero ou non. Avec les 
instructions dont nous avons discute jusqu'ici, ceci ne peut pas se faire. Ce dont nous avons 
besoin est une instruction qui realise un branchement conditionnel a une autre instruction. C'est 
ce que fait I'instruction IF. ..THEN. 

Tapez NEW puis tapez ce programme. 
10 INPUTB 

20 IF B=0THENGOTO50 
30 PRINT "NON-ZERO" 
40 GOT0 10 
50 PRINT "ZERO" 
60 GOT0 10 

Lorsque ce programme passe, il va imprimer un point d'interrogation et attendre que vous tapiez 

une valeur pour B. 

Tapez la valeur que vous voulez. 

L'ordinateur va alors arriver a I'instruction IF. Entre la portion IF et la portion THEN de 
I'instruction, il y a une relation. Cette relation consiste en deux expressions separees par I'un 
des symboles suivants 

SYMBOLE SIGNIFICATION 
EGAL A 

> SUPERIEURA 

< INFERIEUR A 

ooux DIFFERENT DE 

<= INFERIEUR OU EGAL A 

>= SUPERIEUR OU EGAL A 

L'instruction IF est vraie ou fausse, selon que la relation est vraie ou fausse. Dans notre 
programme actuel par exemple si on a tape pour B, la relation B = est vraie. Done 
I'instruction IF est vraie et I'execution du programme se poursuit avec la portion THEN de 
I'instruction: GOTO. A la suite de cette instruction l'ordinateur va sauter a la ligne 50. II va 
imprimer puis I'instruction GOTO de la ligne 60 va renvoyer l'ordinateur a la ligne 10. 
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Supposons que pour B on ait tape le chiffre 1 . Du fait que la relation B == est maintenant 
fausse, I'instruction IF est fausse et I'execution du programme se poursuit par la ligne de 
numeros suivante, en ignorant la portion THEN de I'instruction et toute autre instruction de cette 
ligne. C'est done NON-ZERO qui va etre imprime et I'instruction GOTO de la ligne 40 va 
renvoyer I'ordinateur a la ligne 10. 

Essayez maintenant le programme suivant pour comparer deux nombres (n'oubliez pas de 
taper NEW d'abord, pour effacer votre dernier programme) 
10 INPUTA.B 

20 IF A <=B THEN GOTO 50 
30 PRINT"A IS LARGER" 
40 GOT0 10 

50 IF A <B THEN GOTO 80 

60 PRINT "THEY ARE THE SAME" 

70 GOT0 10 

80 PRINT "B IS LARGER" 
90 GOT0 10 

Lorsque ce programme passe, la ligne 10 fait imprimer un point d'interrogation et attend que 
vous tapiez deux nombres, separes par une virgule. A la ligne 20, si A est superieur a B, A <=B 
est faux et THEN GOTO 50 est ignore. L'execution du programme saute alors a I'execution 
donnee par le numero de ligne suivant, et imprime A IS LARGER et finalement la ligne 40 
renvoie I'ordinateur a la ligne 10 pour recommencer. 

A la ligne 20, si A a la meme valeur que B, A<=B est vrai alors THEN GOTO est execute et 
envoie I'ordinateur a la ligne 50. A la ligne 50 puisque A a la meme valeur que B, A<B est faux. 
Done THEN GOTO 80 est ignore et I'ordinateur passe au numero de ligne suivant, oil on lui 
demande d'imprimer THEY ARE THE SAME. Finalement la ligne 70 envoie I'ordinateur au 
debut. 

A la ligne 20 si A est inferieur a B, A<=B est vrai de sorte que I'execution du programme se 
poursuit avec THEN GOTO 50. A la ligne 50, A<B est vrai done THEN GOTO 80 est execute. 
Finalement on imprime B IS LARGER et on renvoie a nouveau I'ordinateur au debut. 

Essayez de faire passer les deux derniers programmes plusieurs fois. Puis essayez d'ecrire 
votre propre programme en utilisant I'instruction IF. . THEN. En fait essayer d'ecrire des 
programmes vous-meme est la methode la plus rapide et la plus facile de comprendre comment 
travaille APPLESOFT BASIC. N'oubliez pas que pour arreter ces programmes, il suffit de taper 
CONTROL C et d'enfoncer RETURN. 



Un autre exemple concernant la couleur 



Essayons un programme graphique. Notez I'emploi des instructions REM peut donner des 
explications. Les deux-points (:) s'utilisent pour separer les instructions multiples sur une des 
lignes de programme numerotee. Apres avoir tape le programme ci-dessous, demandez a le 
voir par I'instruction LIST et, verifiez que vous I'avez tape correctement. Puis faites-le passer par 
I'instruction RUN. 
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100 GR : Positionner le mode graphique couleur 

110 HOME: Effacer la zone de texte 

120 X=0:Y=5: Positionner la position de depart 

130 XV = 2: Positionner la Vitesse sur I'axe X 

140 YV = 1 : Positionner sur I'axe Y 

150 REM Calculerta nouvelle position 

160 NX=X+XV:NY=Y+YV 

170 REM IF Si la balle depasse le bord de I'ecran, elle rebondit 

180 IFNX>39THENNX=39:XV=-XV 

190 IFNX<0THENNX=0:XV=-XV 

200 IFNY>39THENNY=39:YV=-YV 

210 IFNY<0THENNY=0:YV=-YV 

220 REM PLOT Tracer la nouvelle position en jaune 

230 COLOR= 13: PLOT NX, NY 

240 REM Effacer I'ancienne position 

250 COLOR= 0: Tracer X,Y 

260 Sauvegarder la position actuelle 

270 X=NX:Y=NY 

280 REM STOP AFTER 250 MOVES 

290 I = I + 1 : IF 1 < 250 THEN GOTO 160 

300 PRINT pour revenir a votre programme tapez TEXT 

L'instruction GR demande a APPLE de commuter en mode graphique couleur. II efface 
egalement la zone de trace de 40 par 40 pour la mettre en noir, il positionne I'emplacement de 
sortie de texte en une fenetre de quatre lignes de 40 caracteres chacune en bas de I'ecran et 
definit la nouvelle couleur a tracer comme etant le noir. 

HOME s'utilise pour effacer la zone de texte et positionner le curseur dans Tangle superieur 
gauche de la fenetre actuellement definie pour le texte. Dans le mode graphique couleurs ceci 
se fera au debut de la ligne de texte 20 puisque les lignes de textes a 19 sont maintenant 
utilisees comme zones de trace graphique couleur. 

Les instructions COLOR des lignes 230 et 250 donnent a la nouvelle couleur a tracer la valeur 
de I'expression qui vient a la suite de COLOR=. 

L'instruction PLOT NX,NY de la ligne 230 trace un petit carre de couleur jaune definie par la 
plus recente instruction COLOR, a la nouvelle position specifiee par les expressions NX et NY. 
Se souvenir que NX et NY doivent etre chacun un nombre allant de a 39, sinon te carre sera 
en dehors de I'ecran et il en resultera un message d'erreur. 

De meme l'instruction PLOT X,Y de la ligne 250 trace un petit carre a la position specifiee par 
les expressions X et Y. Mais X et Y sont simplement les anciennes coordonnees NX et NY, 
sauvegardees apres le trace du precedent carre jaune. Par consequent PLOT X,Y repasse sur 
I'ancien carre jaune en y tragant un carre dont la couleur est definie par COLOR= 0. C'est le 
noir, la meme couleur que le fond, c'est pourquoi I'ancien carre jaune semble avoir ete efface. 

Note: pour revenir du mode graphique couleur au mode entierement texte, tapez TEXT puis 
enfoncez la touche RETURN. 

Tapez TEXT comme on vient de le dire est votre fagon d'echapper au mode graphique. Ne 
faites pas attention aux symboles etranges qui se trouvent sur I'ecran - - ils resultent de la 
conversion de I'affichage graphique en caracteres de texte. Si vous n'avez pas compris la ligne 
290, soyez patient. Elle sera expliquee dans les pages suivantes. 

Comme vous le voyez APPLE II peut faire plus que simplement utiliser des nombres. Nous 
reviendrons au mode graphique couleur lorsque vous en aurez appris davantage sur 
APPLESOFT BASIC. 
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FOR... NEXT 



Un avantage des ordinateurs est leur aptitude a executer des taches repetitives. 

Supposons que nous souhaitions avoir une table des racines carrees pour les entiers de 1 a 10. 

La fonction APPLESOFT BASIC pour la racine carree est SQR; la forme etant SQR (X). 

Oil X est le nombre dont on souhaite calculer la racine carree. Nous pourrions ecrire le 

programme comme suit: 

10 PRINT1,SQR(1) 

20 PRINT 2, SQR(2) 

30 PRINT 3, SQR(3) 

40 PRINT 4, SQR(4) 

50 PRINT 5, SQR(5) 

60 PRINT 6, SQR(6) 

70 PRINT 7, SQR(7) 

80 PRINT 8, SQR(8) 

90 PRINT 9, SQR(9) 

100 PRINT 10, SQR(10) 

Ce programme va faire le travail; toutefois il est terriblement inefficace. Nous pouvons 
t'ameliorer beaucoup en utilisant I'instruction IF, que nous venons de voir, comme suit: 

10 N= 1 

20 PRINT N,SQR(N) 
30 N = N + 1 

40 IFN<= 10 THEN GOTO 20 

Lorsque Ton fait passer ce programme ces donnees de sortie sont exactement les memes que 
celles du programme ci-dessus comportant 10 instructions. Voyons comment il travaille 

A la ligne 10 il y a une instruction LET qui donne a la variable N la valeur 1. A la ligne 20 
I'ordinateur doit imprimer N et la racine carree de N, en utilisant la valeur actuelle de N. La ligne 
20 devient done 

20 PRINT 1, SQR (1) 
et le resultat du calcul est imprime. 

A la ligne 30 il y a ce qui nous apparaTt pour la premiere fois etre une instruction LET plutot 
inhabituelle. Mathematiquement I'instruction N = N -I- lest un non-sens. Toutefois la chose 
importante dont il faut se souvenir est que dans une instruction LET, le symbole " = " ne signifie 
pas I'egalite. Dans ce cas " = " signifie "etre remplace par". Cette instruction saisit simplement la 
valeur actuelle de N et lui ajoute 1 . Done apres le premier passage par la ligne 30, N devient 2. 

A la ligne 40 puisque maintenant N est egal a 2, la relation N< = 10 est vraie, done la portion 
THEN de I'instruction renvoie I'ordinateur a la ligne 20, N ayant maintenant la valeur 2. 

Le resultat global est que les lignes 20 a 40 se repetent, en ajoutant chaque fois 1 a la valeur N. 
Lorsque finalement N devient egal a 10 a la ligne 20, la ligne suivante va I'incrementer pour 
I'amener a 1 1 . Ce resultat est une relation fausse pour la ligne 40, la portion THEN est done 
maintenant ignoree et puisqu'il n'y a pas d'autres instructions le programme s'arrete. 

On appelle cette technique 'boucle' ou 'iteration'. Du fait qu'on I'utilise de fagon extensive en 
programmation, il existe des instructions speciales BASIC pour I'utiliser. Nous pouvons les 
montrer avec le programme suivant. 
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10 FOR N = 1 TO 10 
20 PRINT N.SQR (N) 
30 NEXT N 



Les donnees de sortie du programme dont le listage se trouve ci-dessus sont exactement les 
memes que les donnees de sortie des deux programmes precedents. 

A la ligne 10, N est defini comme etant egal a 1. La ligne 20 fait imprimer la valeur de Net de sa 
racine carree. A la ligne 30 nous voyons un nouveau type d'instructions. L'instruction NEXT N 
ajoute une unite a N et si N <= 10, I'execution du programme revient a I'instruction qui suit le 
FOR. II n'y a hen de special a dire concernant N dans ce cas. On peut utiliser n'importe quelle 
variable a condition que ce soit le meme nom de variable dans les deux instructions FOR et 
NEXT. Par exemple on pourrait remplacer N par Z1 partout dans le programme ci-dessus et il 
fonctionnerait exactement de la meme fagon. 

Supposons que nous desirions imprimer une table des racines carrees pour uniquement les 
entiers pairs de 10a 20. Le programme suivant effectuerait cette tache. 

10 N=10 

20 PRINTN.SQR (N) 
30 N=N+2 

40 IFN<=20 THEN GOTO 20 

Notez la structure similaire entre ce programme et celui pour impression des racines carrees 
pour les nombres de 1 a 10. Ce programme peut egalement s'ecrire en utilisant la boucle FOR 
que Ton vient d'introduire. 

10 FOR N=10TO 20 STEP 2 
20 PRINTN.SQR (N) 
30 NEXT N 

Notez que la principale difference entre ce programme et le precedent qui utilise les boucles 
FOR est I'addition STEP 2. Ceci demande a APPLESOFT d'ajouter 2 a N chaque fois, au lieu 
de 1 dans le programme precedent. S'il n'y a pas de STEP indique dans une instruction FOR, 
APPLESOFT suppose que Ton ajoute un chaque fois. Le STEP peut etre suivi de n'importe 
quelle expression. 

Supposons que nous desirions decompter de 10a 1. Un programme pour le faire serait le 
suivant: 

10 1=10 
20 PRINTI 
30 l=M 

40 IFI>= I THEN GOTO 20 

Notez que nous verifions actuellement si I est superieur ou egal a la valeur finale. La raison en 
est que maintenant nous decomptons. Dans les exemples precedents e'etait le contraire et e'est 
pourquoi nous devions verifier si une variable etait inferieure ou egale a la valeur finale. 

L'instruction STEP que Ton vient de voir peut egalement s'utiliser avec des nombres negatifs 
dans le meme but. Ceci peut se faire en utilisant le meme format utilise dans I'autre programme 
comme suit: 

10 FOR I -10 TO I STEP -1 
20 PRINTI 
30 NEXT I 
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Les boucles FOR peuvent egalement s'emboiter. Voici un exemple de cette methode 

10 FOR 1=1 TO 5 
20 FOR J = 1 TO 3 
30 PRINT l,J 
40 NEXT J 
50 NEXT I 

Notez que NEXT J vient avant NEXT I. C'est parce que la boucle J est a I'interieur de la boucle 
I. Le programme suivant est incorrect; executez le et voyez ce qui arrive. 

10 FOR 1=1 TO 5 
20 FOR J = 1 TO 3 
30 PRINTI.J 
40 NEXT I 
50 NEXT J 

II ne marche pas parce que lorsque Ton rencontre NEXT I on perd tout ce que Ton savait sur la 
boucle J. 



Tableaux 



II est souvent commode de pouvoir choisir les elements dans un tableau de nombres. 
APPLESOFT le permet grace a I'emploi des tableaux. 

Un tableau est une table de nombres. Le nom de ce tableau est tout nom legal de variable, A, 
par exemple. Le nom de tableau A est distinct de la simple variable A et vous pouvez utiliser I'un 
et I'autre dans le meme programme. 

Pour choisir un element d'un tableau, nous donnons a A un indice: c'est-a-dire que pour choisir 
I'element d'ordre I, nous mettons I entre parentheses et nous faisons suivre A de cet indice. Par 
consequent A(l) est I'element d'ordre I du tableau A. 

Note: dans cette section du manuel nous ne serons concernes que par les tableaux a une 
dimension; pour une discussion complementaire des instructions APPLESOFT relatives aux 
tableaux, voir chapitre 5 "tableaux et chaTnes". 

A(l) n'est qu'un element du tableau A. APPLESOFT doit savoir combien de place il faut reserver 
pour la totalite du tableau; c'est-a-dire quelles sont les dimensions maxima du tableau. Ceci se 
fait avec I'instruction DIM, en utilisant te format DIM A (15). 



Dans ce cas nous avons reserve un emplacement pour permettre au tableau d'indice I d'aller de 
O ai 5. Les indices de tableau commencent toujours a 0; par consequent dans I'exemple 
precedent nous avons reserve la place pour 16 nombres du tableau A. 

Si on utilise A(l) dans un programme avant de I'avoir dimensionne a I'aide de I'instruction DIM, 
APPLESOFT reserve un emplacement pour 11 elements (indices O a 10). 

Comme exemple de la fagon d'utiliser les tableaux, essayez te programme suivant qui trie une 
liste de 8 nombres que vous avez tapes. 
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90 DIM A(8) : DIMENSION ARRAY WITH MAX. 9 ELEMENTS 

100 REMASKFOR8NUMBERS 

110 FORI=1T08 

120 PRINT'TYPEANUMBER:"; 

130 INPUTA(I) 

140 NEXTI 

150 REM PASS THROUGH 8 NUMBERS, TESTING BY PAIRS 
160 F=0:REMRESETTHEORDERINDICATOR 
170 FORI=1T07 

180 IFA(1)<=A(1+1)THENGOTO140 
190 REM INTERCHANGE A(1)ANDA(1+1) 
200 T=A(1 ) 21 A(1 )=A(1 +1 ) 220 A(1 +1 )=T 
230 F = 1 : REM ORDER WAS NOT PERFECT 
240 NEXTI 

250 REM F =0 MEANS ORDER IS PERFECT 

260 IF F = 1 THEN GOTO 1 60 : REM TRY AGAIN 

270 PRINT:REMSKIPALINE 

280 REM PRINT ORDERED NUMBERS 

290 FOR I = 1 TO 8 

300 PRINT A(l) 

310 NEXTI 

Lorsque la ligne 90 s'execute, APPLESOFT reserve la place pour 9 valeurs numeriques, A (0) a 
A (8). Avec les lignes 1 1 0a 1 40, 1'utilisateur donne la liste non thee. Le tri lui-meme se fait sur les 
lignes 170 a 240, en explorant la liste des nombres et en inter changeant tout couple de deux 
nombres qui ne sont pas dans I'ordre. S est I'indicateur d'ordre parfait. F = 1 indique que Ton 
vient d'inter changer deux nombres. Dans ce cas la ligne 260 demande a I'ordinateur de revenir 
en arriere et de recommencer a verifier. 

Si un passage complet se fait a travers les huit nombres sans avoir a en inter changer (ce qui 
signifie qu'ils sont tous en ordre), les lignes 290 a 310 vont imprimer la liste ainsi thee. Notez 
qu'un indice peut etre n'importe quelle expression. 



GOSUB . . . RETURN 



Un autre couple utile destructions est GOSUB et RETURN. Si votre programme execute la 
meme action en plusieurs endroits differents, vous pouvez utiliser des instructions GOSUB et 
RETURN pour eviter de dupliquer toutes les memes instructions pour cette action a chaque 
emplacement dans le programme. 

Lorsqu'elle rencontre une instruction GOSUB, APPLESOFT execute un branchement sur ta 
ligne dont le numero suit GOSUB. Mais APPLESOFT se souvient de I'endroit oil Ton etait dans 
le programme avant ce branchement. Lorsqu'on rencontre I'instruction RETURN, APPLESOFT 
revient a la premiere instruction qui suit la derniere instruction GOSUB executee. Considerons 
le programme suivant: 
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20 PRINT "WHAT IS THE FIRST NUMBER"; 

30 GOSUB 100 

40T = N: REM SAVE INPUT 

50 PRINT "WHAT IS THE SECOND NUMBER"; 

60 GOSUB 100 

70 PRINT "THE SUM OF THE TWO NUMBERS IS"; T + N 
80 STOP: REM END OF MAIN PROGRAM 
100 INPUT N : REM BEGIN INPUT SUBROUTINE 
110 IFN=INT(N)THENGOTO140 

120 PRINT "SORRY, NUMBER MUSTBE AN INTEGER. TRY AGAIN." 
130 GOTO100 

140 RETURN: REM END OF SUBROUTINE 

Ce programme demande deux nombres qui doivent etre des entiers plus imprime la somme de 
ces deux nombres. Le sous-programme de ce programme est constitue par les lignes 100 a 
140. Ce sous-programme demande un nombre et si le nombre tape dans la reponse n'est pas 
un entier, il en demande un autre. II continue jusqu'a ce que Ton tape une valeur entiere. 

Le programme principal imprime WHAT IS THE FIRST NUMBER (quel est le premier nombre) 
puis appelle le sous-programme pour avoir la valeur du nombre N. Lorsque le sous-programme 
renvoie (a la ligne 40) le nombre qui a ete tape (N) est sauvegarde sous forme de la variable T. 
Ceci se fait dans le but que, lorsque le sous-programme est appele une seconde fois, on ne 
perde pas la valeur du premier nombre. 

WHAT IS THE SECOND NUMBER (quel est le second nombre) est alors imprime et le sous- 
programme est a nouveau appele, le temps de prendre te second nombre. 

Lorsque le sous-programme renvoie pour la seconde fois a la ligne 70, on imprime THE SUM 
OF THE TWO NUMBERS IS fia somme des deux nombres est), suivie de la valeur de leur 
somme. T contient la valeur du premier nombre tape et N contient la valeur du second nombre. 

L'instruction suivante du programme est une instruction STOP. Ceci oblige le programme a 
arreter I'execution a la ligne 80. Si Ton n'avait pas prevu une instruction STOP a ce point, 
I'execution du programme retomberait dans le sous-programme a la ligne 100. Ceci n'est pas 
souhaitable car on nous demanderait encore de taper un autre nombre. Si nous le faisions, le 
sous-programme essaierait de donner une instruction RETURN; et comme il n'y avait pas 
destructions GOSUB pour appeler le sous-programme, il se produirait une erreur. Chaque 
instruction GOSUB dans un programme doit avoir une instruction RETURN correspondante 
executee ensuite et on ne doit rencontrer une instruction RETURN que si elle fait partie d'un 
sous-programme qui etait appele par une instruction GOSUB. 

On peut utiliser soit l'instruction STOP soit l'instruction END pour separer un programme de ses 
sous-programmes. L'instruction STOP va imprimer un message disant a quelle ligne on a 
rencontre le STOP; END va terminer le programme sans donner de message. Les deux 
instructions renvoient la commande a I'utilisateur en imprimant le caractere APPLESOFT ] et un 
curseur clignotant. 



READ... DATA... RESTORE 



Supposons que vous vouliez que votre programme utilise les nombres qui ne changent pas 
chaque fois que Ton execute le programme mais qu'il soit possible de changer facilement si 
necessaire. BASIC contient des instructions speciales dans ce but appelees des instructions 
READ et DATA. 
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Considerons le programme suivant: 

10 PRINT"GUESS A NUMBER": 
20 INPUT G 
30 READ D 

40 IF D- -999999 THEN GOTO 90 
50 IF DoG THEN GOTO 30 
60 PRINT'YOU ARE CORRECT" 
70 END 

90 PRINT'BAD GUESS, TRY AGAIN." 
95 RESTORE 
100 GOT0 10 

110 DATA 1,393,-39,28,391,-8,0,3,14,90 
120 DATA 89,5,10,15,-34,-999999 

Voici ce qui se passe lorsqu'on execute le programme: lorsque Ton rencontre l'instruction 
READ, I'effet est le meme que si c'etait l'instruction INPUT, mais au lieu d'entrer un nombre au 
clavier, on lit un nombre au moyen des instructions DATA. 

La premiere fois que Ton a besoin d'un nombre pour une instruction READ, le premier nombre 
de la premiere instruction DATA est renvoye. La seconde fois c'est le second nombre de la 
premiere instruction DATA qui est renvoye. Lorsque la totalite du contenu de la premiere 
instruction DATA a ete lue de cette fagon, c'est la seconde instruction DATA qui sera utilisee. 
DATA est toujours lue sequentiellement de cette fagon et il peut y avoir un nombre quelconque 
destructions DATA dans votre programme. 

Le but de ce programme est de jouer un jeu dans lequel vous essayez de deviner un des 
nombres contenus dans les instructions DAIA. Pour chaque reponse a la devinette que vous 
tapez, I'ordinateur lit tous les nombres contenus dans les instructions DATA jusqu'a ce qu'il 
trouve le nombre qui corresponde a ce que vous avez tape. Si READ renvoie -999999 c'est que 
tous les nombres disponibles en DATA ont ete utilises et qu'il faut poser une nouvelle question. 

Avant de passer a ta ligne 10 pour une nouvelle question, nous devons faire en sorte que READ 
commence a nouveau par te premier element des donnees. C'est la fonction de RESTORE. 
Apres que Ton a rencontre RESTORE, la premiere donnee qui sera lue sera a nouveau le 
premier poste de la premiere instruction DATA. 

Les instructions DATA peuvent se placer a n'importe quel endroit du programme. Seules les 
instructions READ utilisent les instructions DATA dans un programme et si on rencontre ces 
instructions DATA a un autre moment pendant I'execution d'un programme, elles seront 
ignorees. 



Variables reelles entieres et chaines 



II y a trois types differents de variables utilises dans APPLESOFT BASIC. Jusqu'ici nous n'en 
avons utilise qu'un seul type - les variables en precision reelle. Les nombres de ce mode sont 
affiches avec jusque 9 chiffres decimaux de precision et peuvent aller jusqu'a environ 10 a la 
puissance 38. APPLESOFT convertit vos nombres de I'ecriture decimale a I'ecriture binaire pour 
son usage interne puis a nouveau en ecriture decimale lorsque vous lui demandez d'imprimer la 
reponse. Du fait des erreurs par arrondi et autres erreurs imprevues, les routines internes de 
mathematiques comme racine carree, division et exposant ne donnent pas toujours le nombre 
exact que vous attendiez. 

Le nombre de places a droite du point decimal peut se definir en arrondissant la valeur avant de 
I'imprimer. La formule generale pour ce faire est 
X=INT(X*1 A D+.5)/INT(1 A D+.5) 
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Dans ce cas D est le nombre de places decimales. Une fagon plus rapide de definir le nombre 
de places decimales est de poser P= 10 A D et d'utiliser la formule 
X = INT(X*P+.5)/P 

ou P= 10 correspond a une place, P= 100 a deux places, P= 1000 a trois places . ..etc. ..Ce qui 
precede fonctionne pour X>=1 et X<999999999. Une routine pour limiter le nombre de chiffres 
apres le point decimal est donnee dans la section suivante de ce chapitre. 



Le tableau ci-dessous resume les trois types de variables utilisees dans la programmation 
APPLESOFT BASIC 



Description 


Symbole a mettre a la suite du 
nom de la variable 


Exemple 


ChaTnes (0 a 255 caracteres) 


$ 


ASALPH 






A$ 


Entiers (doivent aller de - 


% 


B% 


32767 ...a +32767....) 




C1% 


Precision reelle (exposant -38 


Aucun 


C 


a+38 avec 9 chiffres 




Boy 


decimaux) 





Une variable entiere ou une variable chaine doit etre suivie de % ou $ a chaque emploi de cette 
variable. Par exemple X,X% et X$ sont des variables differentes. 



Les variables entieres ne sont pas autorisees dans les instructions FOR ou DEF. Le plus grand 
avantage des variables entieres est leur emploi dans les operations sur les tableaux, partout ou 
c'est possible, pour economiser de la place en memoire. 

Toutes les operations arithmetiques se font en precision reelle. Les entiers et les variables 
entieres sont converties en precision reelle avant d'etre utilisees dans un calcul. Les fonctions 
SIN, COS, ATN, TAN, SQR, LOG, EXP et RND convertissent egalement leurs arguments en 
precision reelle et donnent les resultats de meme. 

Lorsqu'un nombre est converti en un entier, il est tronque (arrondi par le bas). 
Par exemple 

l%=.999 A%=-.01 

PRINTI% PRINTA% 

-1 

Si vous affectez un nombre reel a une variable entiere puis si vous imprimez la valeur de la 
variable entiere, c'est comme si la fonction INT avait ete appliquee. II n'y a pas de conversion 
automatique entre les chaines et les nombres. Le fait d'affecter un nombre a une variable 
chaine par exemple se traduit par un message d'erreur. Par contre, il existe des fonctions 
speciales pour convertir un type dans I'autre. 



Chaines 



On se refere a une sequence du caractere sous le nom "expression litterale". Une 'chaine' est 
une expression litterale entre guillemets. Les expressions suivantes sont toutes des chaines: 
"BILL" 
"APPLE" 

"THIS IS A TEST" 

Comme aux variables numeriques, on peut affecter des valeurs specifiques aux variables 
chaines. Les variables chaines se distinguent des variables numeriques par un $ apres leur 
nom variable. 
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Par exemple, essayez ce qui suit: 
A$ = "GOODMORNING" 
PRINTA$ 
GOOD MORNING 

Dans cet exemple nous avons affecte a la variable chaine A$ la valeur chaine "GOOD 
MORNING". 

Maintenant que nous avons donne a A$ une valeur chaine, nous pouvons chercher quelle est la 
longueur de cette valeur (c'est-a-dire le nombre de caracteres qu'elle contient). Nous operons 
comme suit: 

PRINT LEN(A$), LENC'YES") 

12 3 

La fonction LEN fournit un entier egal au nombre de caracteres de la chaine: c'est-a-dire sa 
LENgth (longueur). 

Le nombre de caracteres d'une expression chaine peut aller de a 255. Une chaine qui 
contient caracteres s'appelle une chaine 'nulle'. Avant d'attribuer une valeur du programme a 
une variable chaine, cette variable est initialised a la chaine nulle. Le fait d'imprimer une chaine 
nulle sur le terminal ne fait pas imprimer de caracteres et le curseur ne s'avance pas a la 
colonne suivante. Essayez ce qui suit: 

PRINT LEN(Q$); Q$; 3 

03 

Une autre fagon de creer une chaine nulle est d'utiliser 

Q$ = "" 
ou Instruction equivalente 

LET Q$ = "" 

Le fait d'attribuer une chaine nulle a une variable chaine peut s'utiliser pour liberer I'espace 
chaine utilise par une variable chaine non nulle. Mais vous pouvez avoir des ennuis en 
attribuant la chaine nulle a une variable chaine, comme on le discutera au chapitre 7 au titre de 
I'instruction IF. 

II est souvent souhaitable de retrouver une partie d'une chaine et de la traiter. Maintenant que 
nous avons attribue la valeur A$ a ".GOOD MORNING", nous pouvons ne vouloir imprimer que 
les quatre premiers caracteres de A$. 
Nous pouvons le faire comme suit: 

PRINT LEFT$(A$,4) 

GOOD 

LEFT$(A$,N) est une fonction chaine qui renvoie une sous-chaine composee des N caracteres 
les plus a gauche de son argument de chaine, A$ dans ce cas. Voici un autre exemple: 
FOR N = 1 TO LEN(A$) : PRINT LEFT$(A$,N) : NEXT N 
G 

GO 

GOO 

GOOD 

GOOD 

GOOD M 

GOOD MO 

GOOD MOR 

GOOD MORN 

GOOD MORNI 

GOOD MORNIN 

GOOD MORNING 

Puisque A$ a douze caracteres, cette boucle va s'executer avec N=1, 2,3, ...,1 1 ,12. Au premier 
passage le premier caractere sera seul imprime; au second passage les deux premiers 
caracteres seront imprimes, etc. . . . 
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II existe une autre fonction chaine nominee RIGHTS. RIGHT$(A$,N) renvoie les N caracteres 
les plus a droite a partir de I'expression chaTne A$. Essayez de remplacer RIGHTS par LEFT$ 
dans I'exemple precedent et regardez ce qui arrive. 

II existe egalement une fonction chaTne qui nous permet de prendre les caracteres qui se 
trouvent au milieu de la chaTne. Essayez ce qui suit: 

FOR N = 1 TO LEN(A$) : PRINT MID$(A$,N) : NEXT N 

MID$(A$,N) renvoie une sous-chaTne qui commence a la position d'ordre N de A$ et qui va 
jusqu'a la fin (dernier caractere) de A$. La premiere position de la chaTne est la position 1 et la 
derniere position possible de la chaTne est la position 255. 

Tres souvent il est souhaitable de n'extraire que le caractere d'ordre N dans la chaTne. Ceci 
peut se faire en appelant MID$ avec trois arguments: MID$(A$,N, 1). Le troisieme argument 
specifie le nombre de caracteres a renvoyer, commengant par le caractere N. 
Par exemple: 

FOR N=1TO LEN(A$): PRINT MID$(A$,N, 1 ),MID$(A$,N,2):NEXTN 



G GO 

O 00 

O OD 

D D 
M 

M MO 

OR 
R RN 
N Nl 

1 IN 
N NG 
G G 



Voir te chapitre 5 pour avoir davantage de details sur le mode de travail de LEFT$, RIGHTS et 
MID$. II est egalement possible de concatener des chames (c'est-a-dire de les reunir) par 
I'utilisation de I'operateur plus ( + ). Essayez ce qui suit: 
B$ = A$+" "+ "BILL- 
PRINT B$ 

GOOD MORNING BILL 

La concatenation est particulierement utile si vous souhaitez extraire une chaTne et la replacer 
avec de legeres modifications. Par exemple 

C$ = RIGHT$(B$.3) + "-" + LEFT$(B$,4) + "-" + MID$(B$,6,7) 

PRINT C$ 

BILL-GOOD-MORNING 

Parfois il est souhaitable de convertir un nombre en sa representation chaTne et vis-versa. Les 
fonctions VAL et STR$ effectuent ces taches. Essayez ce qui suit. 

STRINGS = "567.8" 

PRINT VAL(STRING$) 

567.8 

STRINGS = STR$(3.1415) 

PRINT STRINGS, LEFT$(STRING$,5) 

3.1415 3.141 
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La fonction STR$ peut s'utiliser pour modifier les nombres pour leur donner un certain format, 
pour I'entree ou, la sortie. Vous pouvez convertir un nombre en une chaTne puis utiliser LEFT$, 
RIGHTS, MID$ et la concatenation pour redonner au nombre le format desire. 
Le court programme qui suit demontre comment on peut utiliser les fonctions chaTnes pour 
modifier le format de sorties numeriques. 

100 INPUT "TYPE ANYNUMBER: "; X 
110 PRINT:REM SKIP A LINE 

120 PRINT "AFTER CONVERSION TO REAL PRECISION," 
130 INPUT "HOW MANY DIGITS TO RIGHT OF DECIMAL? ": D 
140 GOSUB 1000 

150 PRINT"***" :"REM SEPARATOR" 
160 GOTO 100 

1000 X$=STR$(X): REM CONVERT INPUT TOSTRING 

1010 REM FIND POSITION OF E, IF IT EXISTS 

1020 FORI=1 TO LEN(X$) 

1030 IF MID$(X$,1,1) <>"E" THEN NEXT I 

1040 REM I IS NOW AT EXPONENT PORTION (OR END) 

1050 REM FIND POSITION OF DECIMAL, IF ITEXISTS 

1060 FORJ = I TO 1-1 

1070 IF MID$(X$,J,1)o"."THEN NEXT J 

1080 REM J IS NOW AT DECIMAL (OR END OFNUMBER PORTION) 

1090 REM DO D DIGITS EXIST TO RIGHTOF DECIMAL? 

1100 IFJ+D<=I-1THEN N=J+D : GOTO 1 130:REM YES 

1110 N = 1-1: REM NO, SO PRINT ALL DIGITS 

1 120 REM PRINT NUMBER PORTION AND EXPONENT PORTION 

1130 PRINT LEFT$(X$,N) + MID$(X$,I) 

1140 RETURN 

Le programme ci-dessus utilise un sous-programme commengant a la ligne 1000 pour imprimer 
une variable reelle predefinie X tronquee, et non arrondie, pour la limiter a D chiffres apres le 
point decimal. Les variables X$, I et J sont utilisees dans le sous-programme comme variables 
locales. 

La ligne 1000 convertit la variable reelle X en la variable chaTne X$. L PS lignes 1020 et 1030 
explorent ta chaTne pour voir s'il y a un E (exposant). S'il y a un E, I est place a la position de ce 
E, ou s'il n'y en a pas, a la position LEN(X$) +1. Les lignes 1060 et 1070 cherchent s'il y a un 
point decimal dans la chaTne. S'il y a un point decimal J est place a sa position ou s'il n'y en a 
pas, a la position 1-1. 

La ligne 1100 teste s'il existe au moins D chiffres a droite du point decimal. S'ils existent, la 
portion nombre de la chaTne doit etre tronquee a la longueur J-l-D, qui est D positions a droite 
de J, la position du point decimal. La variable N est positionnee a cette longueur. 
S'il y a moins de D chiffres a droite du point decimal, on peut utiliser la portion entiere du 
nombre. La ligne 1 1 1 positionne ta variable N a cette longueur (I - 1 ) 

Finalement ta ligne 1130 imprime la variable X sous la forme de concatenation de deux sous- 
chaTnes. LEFT$ (X$,N) renvoie tes chiffres significatifs de la portion nombre et MID$(X$,1) 
renvoie la portion exposant s'il y en a un. 

STR$ peut egalement s'utiliser pour trouver commodement combien de positions d'impression 
un nombre va prendre. Par exemple 

PRINT LEN(STR$(33333.157)) 

Si vous avez une application ou un utilisateur tape une question comme 

WHAT IS THE VOLUME OF A CYUNDER OF RADIUS 5.36 FEET 
AND HEIGHT 5.1 FEET? 
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(quel est le volume d'un cylindre de rayon 5.36 pieds et de hauteur 5.1 pieds) 
vous pouvez utiliser la fonction VAL pour extraire les valeurs numeriques 5.36 et 5.1 de cette 
question. Dans le chapitre 5 se trouve une information supplemental concernant ces fonctions 
ainsi que les fonctions CHR$ et ASC. 

Le programme suivant trie une liste de donnees chaTnes et imprime la liste par ordre 
alphabetique. Ce programme est tres semblable a celui donne precedemment pour trier une 
liste numerique. 

100 DIM A$(15) 

110 FORI=1 TO 15:READA$(1):NEXTI 
120 F=0:l=1 

130 IFA$(I)<=A$(I+1)THEN GOTO 180 
140 T$=A$(I+1) 
150 A$(l+1)=A$(t) 
160 A$(I)=T$ 
170 F=1 

180 1=1+1 :IFI<=1 5 THEN GOTO 130 

190 IF F=1 THEN GOTO 120 

200 FOR I = 1 TO 15: PRINT A$(l) : NEXT I 

220 DATA APPLE,DOC,CAT,RANDOM,COMPUTER,BASIC 

230 DATA MONDAY,"***ANSWER***","FOO:" 

240 DATA COMPUTER, FOO.ELP, MILWAUKEE, SEATTLE, ALBUQUERQUE 



En savoir davantage sur le graphique couleur 



Dans les deux precedents exemples, nous avons explique comment APPLE II peut faire aussi 
bien le graphique couleur que le texte. En mode graphique APPLE affiche jusque 1600 petits 
carres, en une quelconque des 1 6 couleurs possibles selon une trame de 40 par 40. On dispose 
egalement de 4 lignes de texte en bas de I'ecran. L'axe X ou axe horizontal est standard, avec 
comme position la plus a gauche et 39 la plus a droite. L'axe Y ou vertical est non standard en 
ce sens qu'il est inverse: est la position la plus haute et 39 la plus basse. 

10 GR : REM INITIALIZE COLOR GRAPHICS: 
SET 40X40 TO BLACK. 

SET TEXT WINDOW TO 4 LINES AT BOTTOM 
20 HOME : REM CLEAR ALL TEXT AT BOTTOM 
30 COLOR = 1 : PLOT 0,0 : REM MAGENTA SQUARE AT 0,0 
40 LIST30:GOSUB1000 

50 COLOR = 2 : PLOT 39,0 : REM BLUE SQUARE AT X=39,Y = 
60 HOME :LIST 50 :GOSUB 1000 

70 COLOR = 12 : PLOT 0,39 : REM GREEN SQUARE AT X=0,Y=39 
80 HOME :LIST 70 :GOSUB 1000 

90 COLOR = 9: PLOT 39,39: REM ORANGE SQUARE AT X=39,Y=39 
100 HOME :LIST 90 :GOSUB 1000 

110 COLOR = 13: PLOT 19,19: REM YELLOW SQUARE AT CENTER OF SCREEN 

1 20 HOME :LIST 110 :GOSUB 1 000 

130 HOME : PRINT "PLOT YOUR OWN POINTS" 

140 PRINT "REMEMBER, X & Y MUST BE > =0 & < =39" 

150 INPUT "ENTER X,Y:";X,Y 

160 COLOR = 8 : PLOT X,Y : REM BROWN SQUARES 

170 PRINT "TYPE 'CTRL C AND PRESS RETURN TO STOP" 

180 GOT0 150 

1000 PRINT '""HITANYKEYTO CONTINUE"*";: GETA$: RETURN 



GUIDE PRATIQUE DU BASIC ETENDU 21 



Apres avoir tape ce programme demandez-en le listage par I'instruction et verifier s'il y a des 
erreurs de frappe. Vous pouvez demander a le sauvegarder sur une bande cassette pour 
utilisation future. Puis faTtes passer le programme (instructions RUN). 

L'instruction GR demande a APPLE de commuter en mode graphique couleur. L'instruction 
COLOR definit la prochaine couleur a tracer. Cette couleur reste definie jusqu'a ce qu'elle soit 
modifiee par une nouvelle instruction COLOR. Par exemple la couleur tracee a la ligne 160 
demeure la meme independamment du nombre de points a tracer. La valeur de I'expression qui 
suit COLOR doit etre de a 255 sinon il peut se produire une erreur. Mais il n'y a que 16 
couleurs differentes, habituellement numerotees de a 15. 
Modifiez le programme en retapant tes lignes 150 et 160 comme suit: 

150 INPUT "ENTER X, Y, COLOR:"; X, Y, Z 

160 COLOR =Z:PLOT X,Y 

Maintenant faTtes passer le programme (instructions RUN et vous pourrez choisir vos propres 
couleurs ainsi que les points. Nous allons faire une demonstration de I'etendue de couleurs de 
APPLE a la suite 

L'instruction PLOT X,Y trace un petit carre de couleur definie par, la derniere instruction COLOR 
a la position specifiee par les expressions X et Y. N'oubliez pas que X et Y doivent un nombre 
de O a 39, L'instruction GET de la ligne 1000 est semblable a une instruction INPUT. Lorsque 
cette instruction apparaTt I'ordinateur attend que vous tapiez un seul caractere au clavier et 
affecte ce caractere a la variable qui suit l'instruction GET. II n'est pas necessaire d'enfoncer la 
touche RETURN. A la ligne 1000, GET/A$ est simplement utilise pour arreter le programme 
jusqu'a ce que vous enfonciez une touche. 

N'oubliez pas: pour repasser du mode graphique couleur au mode entierement texte, tapez 
TEXT puis enfoncez la touche RETURN. Le caractere APPLESOFT apparaTtra alors. 
Tapez le programme suivant et faTtes-le passer (instructions RUN pour afficher la plage de 
couleurs de APPLE) n'oubliez pas de taper tout d'abord NEW. 

10 GR: HOME 

20 FOR T=0TO31 

30 COLOR = I/2 

40 VLIN 0.39 AT I 

50 NEXT I 

60 FOR l= TO 14 STEP 2:PRINT TAB(I*2+1);I;:NEXT I 
70 PRINT 

80 FORI=1 TO 15 STEP 2:PRINT TAB(I*2+1 );I;:NEXTI 
90 PRINT: PRINT "STANDARD APPLE COLOR BARS"; 

Les rectangles de couleur sont affiches au double de leur largeur normale. Le rectangle le plus 
a gauche est noir, etant defini par COLOR = 0; le plus a droite est blanc, defini par COLOR = 
15. Selon le reglage de couleurs de votre appareil TV, le second rectangle defini par COLOR = 
1 sera magenta (pourpre-rougeatre) et le troisieme (COLOR = 2) sera bleu fonce. Reglez votre 
appareil TV pour obtenir ces couleurs. En Europe les valeurs des couleurs peuvent etre 
differentes. 

Dans te dernier programme on a utilise ligne 40 une instruction de la forme VLIN Y 1 , Y2 AT X. 
Cette instruction trace une ligne verticale partant de la coordonnee Y specifiee par I'expression 
Y1 jusqu'a la coordonnee Y specifiee par I'expression Y2, a la position horizontale specifiee par 
I'expression Y. Y1 , Y2 et X doivent prendre des valeurs de a 39. Y2 peut etre superieur ou 
egal ou inferieur a Y 1 . L'instruction HLIN XI, X2 AT Y est semblable a VLIN mais elle trace une 
ligne horizontale. 



Note: APPLE trace une ligne entiere aussi facilement qu'un point unique. 
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Graphique couleur haute resolution 



Maintenant que vous etes familiarise avec le graphique basse resolution de APPLE, vous allez 
trouver facile de comprendre le graphique haute resolution. Les instructions ont un aspect 
semblable: habituellement elles sont formees en ajoutant simplement un H (pour haute 
resolution) a celles que vous connaissez deja. Par exemple I'instruction HGR definit le mode 
graphique haute resolution, efface I'ecran haute-resolution pour le mettre entierement noir et 
laisse 4 lignes de texte en bas de I'ecran. Dans ce mode, vous tracez des points sur une trame 
de largeur 280 positions X et de hauteur 1 60 positions Y. 

Ceci vous permet de dessiner sur I'ecran avec beaucoup plus de details qu'avec la trame de 40 
par 40 du graphique basse resolution. En tapant TEXT vous revenez au mode normal texte. En 
plus de I'ecran HGR il existe egalement un deuxieme ecran haute resolution que vous pouvez 
utiliser si votre APPLE contient au moins 24 K octets de memoire. Le mode graphique haute 
resolution pour cette seconde 'page de memoire' s'obtient par I'instruction 
HGR2 

Cette instruction efface la totalite de I'ecran pour le rendre noir, ce qui vous assure une surface 
de trace de largeur 280 positions X et de hauteur 192 positions Y, sans texte en bas. A nouveau 
il faut taper TEXT pour voir votre programme. 

Vraiment merveilleux? En effet; mais pour cette nouvelle possibility vous devez faire des 
sacrifices il y a moins de couleurs. La couleur du graphique haute resolution est definie par une 
instruction de la forme 
HCOLOR = N 

ou N est un nombre de (noir) a 7 (blanc). Voir au chapitre 8 une liste complete des couleurs 
disponibles. Du fait du mode de construction des appareils de television couleur, ces couleurs 
varient d'un appareil a I'autre et d'un trait a I'autre du trace. 

Enfin, il existe une instruction facile pour tous les traces en graphique haute resolution. Pour 
I'avoir en action, tapez 

HCOLOR = 3 

HGR 

HP LOT 130,100 

La derniere instruction trace un point haute resolution dans la couleur que vous avez definie 
avec HCOLOR (blanc) au point X = 130, Y = 100. Comme en graphique basse resolution, X = 
est sur le bord gauche de I'ecran, en allant en croissant vers la droite; Y = est en haut de 
I'ecran, en allant en croissant vers le bas. La valeur maxima de X est 279: la valeur maxima de 
Y est 191 (mais dans le mode mixte graphique plus texte de HGR, les valeurs Y ne sont visibles 
vers le bas que jusqu'e Y = 1 59). 
Maintenant tapez 

HPLOT 20.15 TO 145.80 
Comme par magie, une droite blanche est tiree du point X = 20, Y = 15 au point X = 145, Y = 
80. 

HPLOT peut tirer des droites entre deux points quelconques de I'ecran - horizontalement 
verticalement ou selon un angle quelconque. Desirez-vous relier une autre droite a I'extremite 
de la precedente? Tapez 
HPLOT TO 12,80 

Cette forme destruction prend son point de depart au dernier point precedemment trace et 
prend sa couleur en ce point egalement (meme si vous avez emis une nouvelle instruction 
HCOLOR depuis que ce point a ete trace). Vous pouvez meme 'chaTner' ces instructions en une 
seule instruction. Essayez ceci 

HPLOT 0.0 TO 279,0 TO 279,159 TO 0, 159 TO 0,0 
Vous devriez maintenant avoir une bordure blanche tout autour des quatre cotes de I'ecran. 
Voici un programme qui dessine de jolis dessins moires sur votre ecran. 

80 HOME : REM CLEAR THE TEXT AREA 

100 VTAB24:REM MOVE CURSOR TO BOTTOM LINE 
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120 HGR : REM SET HIGH-RESOLUTION GRAPHICS MODE 

140 A=RND(1)*279:REMPICKANXFOR"CENTER" 

1 60 B=RND(1 )*1 59:REMPICKAYFOR"CENTER" 

180 1% = RND(1) * 4)+2: REM PICK A STEP SIZE 

200 HTAB 15 : PRINT "STEPPING BY"; 1 %; 

220 FOR X=0TO 278 STEP 1%: REM STEP THRUX VALUES 

240 FORS=0TO1 :REM2LINES.FROMXANDX+1 

260 HCOLOR=3*S:REMFIRSTLINEBLACK,NEXTWHITE 

280 REM DRAW UNE THROUGH"CENTER-TO OPPOSITE SIDE 

300 HPLOTX+S,0TOA,BTO279-X-S,159 320 NEXTS, X 

340 FOR Y =0 TOI 58 STEP 1%: REM STEP THRU Y VALUES 

360 FOR S = TOI: REM 2 UNES, FROM Y AND Y+) 

380 HCOLOR-3*S:REMFIRSTLINEBLACK,NEXTWHITE 

400 REM DRAW LINE THROUGH 'CENTER' TO OPPOSITE SIDE 

420 HPLOT279,Y+STOA,BTO0,159-Y-S 

440 NEXTS, Y 

460 FOR PAUSE = 1 TO 1500 : NEXT PAUSE : REM DELAY 
480 GOTO120:REMDRAWANEWPATTERN 

C'est un programme plutot long; tapez-le soigneusement et demandez a le voir sur I'ecran 
(instructions LIST par portion)(UST 0,320 par exemple) pour verifier votre frappe. Nous avons 
ajoute une ligne blanche entre certaines lignes pour en faciliter la lecture. Votre listage ne fera 
pas apparaitre ces blancs. Lorsque vous etes certain qu'il est correct, faTtes passer le 
programme (instructions RUN) 

VTAB et HTAB sont des instructions de deplacement du curseur utilisees pour imprimer un 
caractere a une position predeterminee sur I'ecran en mode texte. VTAB 1 place le curseur sur 
la ligne du haut; VTAB 24 place sur la ligne du bas. HTAB 1 le place dans la position ta plus a 
gauche sur la ligne en cours; HTAB 40 le place a la position la plus a droite. Dans une 
instruction PRINT comme celte de la ligne 200 vous pouvez avoir besoin d'un point et virgule a 
la fin pour eviter une 'alimentation de ligne' a la suite qui viennent deplacer votre message. 
La fonction RND(N) ou N est tout nombre positif fournit un nombre aleatoire de a .999999999 
(voir chapitre 10 pour la discussion complete de RND). La ligne 181 affecte done a la variable 
entiere 1% un nombre aleatoire de 2 a 5 (un nombre est toujours arrondi par valeur inferieure 
lorsqu'il est converti en un entier. La dimension STEP dans la boucle FOR . . . NEXT n'est pas 
obligatoirement un entier mais il peut etre plus facile de predire les resultats pour un STEP 
entier. 

Comme vous le voyez dans les lignes 320 et 440, une instruction peut prevoir le NEXT pour 
plus d'une instruction FOR. FaTtes attention de donner la liste des variables NEXT dans I'ordre 
correct pourtant, pour eviter des boucles croisees. 

La ligne 460 est simplement une 'boucle d'attente' qui vous donne un moment pour admirer un 
dessin avant que le suivant ne commence. Chaque fois que la ligne 480 renvoie I'ordinateur a 
I'instruction HGR de la ligne 120, HGR efface I'ecran pour le dessin suivant. Pour revenir au 
programme arretez le dessin en tapant 

Ctrl C 
puis en tapant 

TEXT 

Avez-vous des idees sur la facon de modifier le programme? Apres avoir sauvegarde cette 
version sur votre enregistreur de cassette ou sur disquette, essayez de modifier au hasard la 
valeur de HCOLOR. Essayez de tirer tout d'abord des traits blancs puis des traits noirs ou 
uniquement des traits blancs. 

JOYEUSE PROGRAMMATION! ? 
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Definitions et abreviations syntaxiques 



(pour une liste alphabetique de ces definitions voir appendice N) 

Les definitions suivantes utilisent des metasymboles comme { et \ --, caracteres utilises pour 
indiquer sans ambiguTte des structures ou des relations dans APPLESOFT. Les metasymboles 
ne font pas partie de APPLESOFT En plus des metasymboles vrais, le symbole special := 
indique le debut d'une definition complete ou partielle du terme qui se trouve a la gauche de := 

| := metasymbole utilise pour separer des alternatives 

(note: un item peut egalement se definir separement pour chaque alternative) 
[ ] := metasymboles utilises pour isoler un element optionnel 

{ } := metasymboles utilises pour isoler un element qui peut se repeter 

\ := metasymbole utilise pour isoler un element dont il faut utiliser la valeur la valeur de 

X s'ecrit \X\ 

:= metasymbole qui indique un espace necessaire 

metasymbole 

:= III I ]|{|}|\| 
Lettres minuscules 

:=a|b|c|d|e|f|g|h|i|j|k|l|m|n|o|p|q|r|s|t|u|v|w|x|y|z 

metasymbole 

:= lettres minuscules 

ch iff res 

:= 1|2|3|4|5|6|7|8|9|0 

metanom 

:= {metasymbole} [chiffre] 

metasymbole 

:= un chiffre unique concatene a un metanom 

symbole special utilise par APPLESOFT II 
:= special 

Special 

:= ! | # | $ | % | & T | ( | ) * | : | = | - @ | + | ; | ? | / 1 > . | < | , | ] | A | " 

Les caracteres de controle (caracteres qui sont tapes tout en maintenant enfoncee la touche 
CTRL) et le caractere nul sont egalement des caracteres speciaux. APPLESOFT utilise le 
crochet a droite (|) uniquement pour le caractere ; dans ce document il est utilise comme 
metasymbole. 

Lettre 

:= A|B|C|D|E|F|G|H|l|J|K|L|M|N|0|P|Q|R|S|T|U|V|W|X|Y|Z 

Caractere 

:= lettre | chiffre | special 
Caracteres alphanumeriques 
:= lettre I chiffre 

nom 

:= lettre [ {lettre I chiffre } ] 
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Un nom peut avoir une longueur allant jusque 238 caracteres. Lorsqu'il faut distinguer un nom 
d'un autre APPLESOFT ignore tout caractere alphanumerique situe apres les deux premiers 
APPLESOFT ne distingue done pas entre les noms GOOD4LITTLE et GOLDRUSH. Toutefois 
meme la partie ignoree d'un nom ne doit pas contenir un special, un guillemet ou un des mots 
reserves de APPLESOFT (voir en appendice A la liste de ces mots reserves et des 
commentaires sur les exceptions a cette regie). 

Entier: 

:=[ + !-]{ chiffres } 
Les entiers doivent etre entre 732767 et 32767. 

Pour convertir des nombres non entiers en entiers, on peut habituellement considerer que 
APPLESOFT tronque le non?entier pour obtenir rentier inferieur le plus proche. Toutefois ce 
n'est pas tout a fait vrai dans la mesure ou le non?entier s'approche de rentier superieur le plus 
proche. 
Par exemple: 

A%=1 23.999 999 959 999 B%=1 23.999 999 96 
PRINT A% PRINT A% 

123 124 

C%=1 2345.999 995 999 D%=1 2345.999 996 
PRINT C% PRINT D% 

12345 12346 

(les lignes blanches ont ete ajoutees pour faciliter la lecture) 

Un entier element d'un tableau occupe deux octets (16 bits) en memoire. Nom d'une variable 
entiere 

:=nom% 

Une variable reelle peut etre enregistree sous forme de variable entiere, mais APPLESOFT 
convertit d'abord la variable reelle en une variable entiere. Nombre reel: 
(en remplagant digit par chiffre) 

:=[ + |_]{digit}[.{digit}][E[ + |?]digit [digit]] 
:=[ + !_][{ digit }].[{ digit } ] [ B [ + | ? ] digit [digit]] 

La lettre E, utilisee dans la notation du nombre reel (une forme de 'notation scientifique') signifie 
'exposant'. C'est I'abreviation de *10 A . Dix est eleve a la puissance du nombre qui se trouve a la 
droite de E et le nombre qui se trouve a la gauche de E est multiplies par le resultat. 

En APPLESOFT les nombres reels doivent aller de ?1E38 a 1E38, sinon vous risquez le 
message OVERFLOW ERROR? 

En utilisant I'addition et la soustraction il est possible que vous obteniez des nombres de 
I'importance de 1.7E38 sans recevoir ce message. Un nombre reel dont la valeur absolue est 
inferieure a environ 2.9388E739 sera converti par APPLESOFT en zero. APPLESOFT 
reconnaTt les nombres suivants comme des nombres reels lorsqu'ils se presentent par 
eux?memes et les evalue pour zero. 

+. -. .E +.E -.E 

,E+ .E- +.E- +.E+ -,E+ -.E- 

Par consequent I'element de tableau M(.) est le meme que M(0). 

En plus des nombres reels abreges de la liste ci?dessus, les suivants sont reconnus comme 
nombre reels et evalues pour zero lorsqu'ils sont utilises comme response numerique a une 
instruction INPUT ou comme elements numeriques de I'instruction DATA. 
+ - E +E -E espace 

E+ E- +E+ +E- -E+ -E- 
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L'instruction GET evalue pour zero tous les nombres reels a simple caractere des listes 
ci?dessus. Lorsqu'on imprime un nombre reel, indiquera au plus 9 chiffres (voir les sections 
ci?dessous) non compris I'exposant (s'il y en a un).Tous les chiffres qui viennent a la suite sont 
arrondis. A la gauche du point decimal, tous les zeros qui precedent le chiffre le plus a gauche 
qui ne soit pas un zero ne sont pas imprimes. A la droite du point decimal tous les zeros qui 
suivent le chiffre le plus a droite qui ne soit pas un zero ne sont pas imprimes. S'il n'y a pas a 
droite du point decimal de chiffres quine soient pas des zeros, le point decimal n'est pas 
imprime. 



Le resultat de I'arrondi peut etre curieux 

PRINT 99 999 999.9 

99 999 999.9 

PRINT 99 999 999.90 

100 000 000 

PRINT 11.111 111 450 00 
11.111 111 5 

PRINT 11.111 111 451 9 
11.111 111 4 

(les espaces blancs sont ajoutes pour faciliter la lecture) 

Si la valeur absolue d'un nombre reel est superieur ou egal a.O 1 et inferieur a 999 999 999.2, le 
nombre reel est imprime en notation a point decimal fixe. C'est?a?dire que I'exposant n'est pas 
affiche. Sur I'etendue 

.0 100 000 000 5 a .0 999 999 999, 
les nombres reels sont imprimes avec dix chiffres maximum, y compris le zero qui se trouve 
immediatement a la droite du point decimal. C'est la seule exception a la limite de 9 chiffres 
imprimes non compris I'exposant. 

Si vous essayez d'utiliser un nombre de plus de 38 chiffres comme 
211.111111111111111111111111111111111111 
alors le message 
?OVERFLOW ERROR 

s'imprime, meme si ce nombre se trouve certainement entre ?1 E38 et 1 E38. Ceci est vrai 
meme si la plus grande partie des chiffres sont des zeros de queue, comme dans 
21 1 .0000000000000000000000000000000000000 

Les zeros de tete toutefois sont ignores. Le premier chiffre est un et si le second chiffre est 
inferieur ou egal a six, des nombres contenant 39 chiffres peuvent s'utiliser sans donner lieu a 
message d'erreur. 

Un nombre reel occupe 5 octets (40 bits en memoire) 

Nom d'une variable reelle 
:=nom 

Variable arithmetique 
:= avar 

avar 

:= nom | nom% 

Toutes les variables simples occupent 7 octets en memoire, 2 octets pour le nom et 5 octets 
pour la valeur reelle ou entiere. 
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Delimiteur 

:=~l(l)H-M A l>l<liri,l;|: 

un nom n'a pas a etre separe d'un mot reserve qu'il precede ou qu'il suit par I'un de ces 
delimiteurs. 

Operateur arithmetique 
:= aop 

aop 

:=+ I* I I r 

Operateur logique arithmetique 
:= alop 

alop 

:= AND|OR|=|>|<|o|><|>=|=>|<=|=< 
C'est volontairement que NOT n'est pas compris ici. 
Operateur 

:= op 

op 

:= aop I alop 

Expression arithmetique 
:= aexpr 

aexpr 

:= avar | nombre reel | nombre entier 
:= (aexpr) 

Si des parentheses sont emboTtees sur plus de 36 niveaux de profondeur, il apparaTt le 
message OUT OF MEMORY ERROR? 
:= [ + | - 1 NOT ] aexpr 

L'operateur unaire NOT apparaTt ici avec les operateurs unaires + et ? 
:= aexpr op aexpr 

Indice 

:= (aexpr [ { , aexpr }]) 

Le nombre maximum de dimensions est 89, bien qu'en pratique il soit limite par la taille de la 
memoire disponible. aexpr doit etre positif et, pour I'utiliser, est converti en un entier. 

avar 

:= indice de avar 

aexpr 

:= indice de avar 

Expression litterale 

:= [ { caractere }] 

ChaTne 

:= " [{ caractere }] " 
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une chaine occupe un octet (8 bits) pour sa longueur, 2 octets pour son pointeur d'emplacement 
et un octet pour chaque caractere de la chaTne. 
:= [ { caractere } ] return 

Cette forme de chaTne ne peut apparaTtre qu'a la fin d'une ligne 
ChaTne nulle 



Nom d'une variable chaTne 

:= nom$ 
Variable chaTne 

:= svar 

svar 

:= nom$ | nom$ indice 

Le pointeur d'emplacement et le nom de la variable occupent chacun deux octets en memoire. 
La longueur et chaque caractere de la chaTne occupent un octet. 
Operateur de chaTne 
:= sop 

sop 

:=+ 

Expression chaTne 
:= sexpr 

sexpr 

:= svar | chaTne 
:= sexpr sop sexpr 

operateur logique de chaTne 
:= slop 

slop 

:= |=|>|<|<>|x|>=|=>|<=|=< 

aexpr 

:= sexpr slop sexpr 

Variable 

:=var 

var 

:= avar | svar 

Expression 

:= expr 

expr 

:= aexpr | sexpr 

Caractere souffleur 
:=] 
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Le crochet a droite est affiche lorsque APPLESOFT est pret a accepter une autre instruction, 
reset 

:= enfoncer la touche marquee "RESET" 

esc 

:= enfoncer la touche marquee "ESC" 

return 

:= enfoncez la touche marquee "RETURN" 

Ctrl 

:= maintenir enfoncee la touche marquee "CTRL" tout en enfongant la touche dont le 

nom suit 

numero de la ligne 

:= Linenum 

Linenum 

:= {chiffre } 

Les numeros de lignes doivent aller de a 63999 sinon il en resulte un message SYNTAX 
ERROR? 

Ligne 

:= Linenum [ ( instruction : } ] instruction return 
Une'ligne peut avoir jusque 239 caracteres. Ceci comprend tous les espaces blancs tapes par 
I'utilisateur, mais ne comprend pas les espaces blancs ajoutes par APPLESOFT pour mettre la 
ligne au format 



Regies d' evaluation des expressions 

Les operateurs sont listes verticalement dans I'ordre d'execution, depuis la plus forte priorite 
(parentheses) jusqu'a la plus faible priorite (OR). Les operateurs listes sur la meme ligne ont la 
meme priorite. A priorite egale dans une expression les operations s'executent en allant de 
gauche a droite. 



+ - NOT operateurs unaires 

A 

7 
+- 

>< >= <= => =< <> >< = 

AND 

OR 
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Conversion de types 

Lorsqu'un nombre entier et un nombre reel sont tous les deux presents dans un calcul, tous les 
nombres sont convertis en nombres reels avant que le calcul ne soit effectue. Les resultats sont 
convertis en le type arithmetique (entier ou reel) de la variable finale a laquelle ils sont affectes. 
Les fonctions definies sur un type arithmetique donne convertissent les arguments d'un autre 
type en le type pour lequel elles sont definies. Les types chaines et arithmetiques ne peuvent 
pas etre melanges. Chaque type doit etre converti dans I'autre type au moyen de fonctions 
prevues dans ce but. 



Modes d'execution 

Imm Certaines instructions peuvent etre utilisees en mode execution immediate (imm) en 
APPLESOFT. En mode execution immediate une instruction doit etre tapee sans numero 
de ligne. Des que Ton enfonce la touche RETURN I'instruction est immediatement 
executee. 

Def Les instructions utilisees en mode execution differee (clef) doivent apparaTtre sur une ligne 
qui commence par un numero de ligne. Lorsqu'on enfonce la touche RETURN, 
APPLESOFT enregistre la ligne numerotee en memoire pour utilisation ulterieure. Les 
instructions en mode a execution differee ne sont executees que lors du RUN 
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CHAPITRE 3 

Instructions du systeme et instructions utilitaires 



34 LOAD et SAVE 
34 NEW 

34 RUN 

35 STOP, END, Ctrl C, reset et CONT 

36 TRACE et NOTRACE 
36 PEEK 

36 POKE 

37 WAIT 

38 CALL 

38 HIMEM: 

39 LOMEM: 

40 USR 



GUIDE PRATIQUE DU BASIC ETENDU 33 



LOAD et SAVE 



imm dif sont les abreviations de immediat et differe & 
LOAD imm & dif 
SAVE imm & if 

Ces instructions chargent LOAD un programme a partir d'une bande sur cassette et 
sauvegardent SAVE un programme sur cassette, respectivement. II n'y a pas de message 
indicateur ou autre signal emis par ces instructions; I'utilisateur doit avoir son lecteur 
enregistreur de cassettes fonctionnant dans le mode correct (lecture ou enregistrement) lorsque 
I'instruction est executee. Les instructions LOAD et SAVE ne verifient pas que le lecteur de 
cassette est en mode correct ou meme qu'il en existe un. Les deux instructions emettent un bip 
pour signaler le debut et la fin des enregistrements ou d'une lecture. 

L'execution du programme se poursuit apres une operation SAVE mais une operation LOAD 
efface le programme en cours lorsqu'elle commence a lire une nouvelle information a partir 
d'une bande sur cassette. 

Seule I'instruction reset peut interrompre une instruction LOAD ou SAVE. 

Si le mot reserve LOAD ou SAVE est utilise comme premiers caracteres d'un nombre de 
variable, 

I'instruction a mot reserve peut etre executee avant que tout message 7SYNTAX ERROR ne 
soit donne. L'instruction 
SAVERING = 5 

fait que APPLESOFT s'efforce de sauvegarder le programme en cours. Vous pouvez attendre 
apres le second bip (et le message 7SYNTAX ERROR) ou enfoncez la touche reset. 

L'instruction LOADTOJOY=47 suspend le fonctionnement du systeme, tandis que APPLESOFT 
efface le programme en cours et attend indefiniment apres un programme en provenance du 
lecteur de cassette. Ce n'est qu'en enfongant la touche dif que vous pouvez reprendre le 
controle de votre ordinateur. 

NEW 



NEW imm dif 

Pas de parametres. Efface le programme en cours et toutes les variables. 

RUN 



RUN imm & dif 
RUN [linenum] 

Cette instruction efface toutes les variables, les pointeurs et les registres et commence 
l'execution a la ligne dont le numero est in dique par linenum. Si le numero de ligne linenum 
n'est pas indique, l'execution commence a la ligne de plus faible numero du programme, ou 
bien cette instruction renvoie le controle a I'utilisateur s'il n'y a pas de programme en memoire. 

En mode execution differee, si le numero de ligne linenum est donne mais si cette ligne n'existe 
pas dans le programme ou si linenum est negatif, il apparait le message 
?UNDEF'D STATEMENT ERROR 

Si le numero de ligne linenum est superieur a 63999, il apparait le message 
7SYNTAX ERROR. 

On ne vous indique pas a quelle ligne I'erreur s'est produite. 
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En mode d'execution immediate d'un autre cote ces deux messages deviennent 
?UNDEF'D STATEMENT ERROR IN XXXX 

et 

7SYNTAX ERROR IN XXXX 
ou XXXX peut etre differents numeros de lignes, habituellement superieurs a 65000 
Si I'instruction RUN est utilisee dans un programme d'execution immediate, toute ou portion 
suivante du programme d'execution immediate n'est pas executee. 

STOP, END, Ctrl C, reset et CONT 



STOP 


imm & dif 


END 


imm & dif 


Ctrl C 


imm 


reset 


imm 


CONT 


imm & dif 


STOP 




END 




Ctrl C 




reset 




CONT 





STOP amene un programme a cesser son execution et renvoie le controle de I'ordinateur a 
I'utilisateur. Cette instruction imprime le message BREAK IN linenum ou linenum est le numero 
de ligne de I'instruction qui a execute le STOP. 

END amene un programme a cesser son execution et renvoie le controle a I'utilisateur. Aucun 
message n'est imprime. 

Ctrl C a un effet equivalent a I'insertion d'une instruction STOP placee immediatement apres 
I'instruction en cours d'execution. Ctrl peut s'utiliser pour interrompre un listage (instruction 
LIST). Elle peut egalement s'utiliser pour interrompre une instruction INPUT mais seulement si 
c'est le premier caractere entre. L'instruction INPUT n'est pas interrompue avant que la touche 
RETURN ne soit enfoncee. 

reset arrete immediatement tout programme ou instruction APPLESOFT inconditionnellement. 
Le programme n'est pas perdu mais certains pointeurs et certains registres sont effaces. Cette 
instruction vous laisse dans le langage moniteur du systeme comme indique par le caractere de 
moniteur ("'). Pour revenir a APPLESOFT sans detruire le programme enregistre en cours, 
tapez Ctrl C return. 

Si I'execution du programme a ete arretee par STOP, END Ctrl C, I'instruction CONT fait que 
I'execution reprend a I'instruction suivante et non pas au numero de ligne suivant. Rien n'est 
efface. Sil n'y a pas de programme arrete, alors I'instruction CONT n'a pas d'effet. Apres reset 
Ctrl C return le programme peut ne pas poursuivre son execution correctement par I'instruction 
CONT car certains pointeurs et supports du programme peuvent avoir ete effaces. 
Si une instruction INPUT est arretee par Ctrl C, un essai de continuer I'execution du programme 
par I'instruction CONT se traduit par un message 7SYNTAX ERROR IN linenum, ou linenum est 
le numero de la ligne qui contient I'instruction INPUT. 

L'execution de I'instruction CONT va se traduire par le message 
?CAN'T CONTINUE ERROR 

si, apres I'arret de I'execution du programme, I'utilisateur a) modifie ou efface une ligne 
quelconque du programme b) essaie toute operation qui se traduit par un message d'erreurs 
Par contre les variables du programme peuvent etre changees a I'aide destructions d'execution 
immediate, pour autant que Ton n'a pas subi de message d'erreur. 
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Si Ton utilise DEL dans une instruction a execution differee, les lignes specifiees sont effacees 
et I'execution du programme s'arrete. Un essai d'utiliser CONT dans ces circonstances amene 
le message: 

?CAN'T CONTINUE ERROR 
Si Ton utilise dans une instruction a execution differee, I'execution du programme s'arrete a 
cette instruction mais le controle de I'ordinateur n'estpas renvoye a I'utilisateur. L'utilisateur peut 
reprendre le controle de I'ordinateur en emettant une instruction Ctrl C mais un essai de 
poursuivre I'execution du programme en introduisant CONT dans I'instruction suivante n'abouti 
qu'a dessaisir le controle et arreter a nouveau le programme: 

TRACE et NOTRACE 

TRACE: imm & dif 
NOTRACE: imm & dif 

TRACE positionne un mode de mise au point qui affiche le numero de ligne de chaque 
instruction lorsqu'elle est executee. Si le programme imprime egalement sur I'ecran, TRACE 
peut y apparaTtre de fagon inattendue ou etre surcharge. NOTRACE supprime le mode de mise 
au point TRACE 

Une fois positionne, TRACE n'est pas supprime par RUN, CLEAR, NEW, DEL ou reset; reset 
Ctrl B supprime TRACE (et elimine tout programme enregistre en memoire) 

PEEK 

PEEK: imm & dif 
PEEK (aexpr) 

donne le contenu, en decimal, de I'octet qui se trouve a I'adresse \aexpr. \ L'appendice J 
contient des exemples de la fagon d'utiliser PEEK. 

POKE 

POKE: imm & dif 
POKE aexprl , aexpr2 

POKE enregistre en memoire un octet, I'equivalent binaire de la valeur decimale \aexpr2 \ a 
I'emplacement dont I'adresse est donnee par aexpr 1 . L'etendue de \aexpr2\ doit etre de a 
255; celle de \,aexpr \ doit etre de 65535 a 65535. Les nombres reels sont convertis en nombres 
entiers avant execution. 

Des valeurs qui se trouvent en dehors de l'etendue amenent I'impression du message 
? ILLEGAL QUANTITY ERROR 

\aexpr2\ ne sera correctement enregistre ue si le materiel informatique correct pour la recevoir 
(memoire ou dispositif de sortie convenable est present a I'adresse specifiee par \aexpr1. \ \ 
aexpr2 \ ne sera pas correctement enregistre a des adresses qui ne peuvent pas la recevoir, 
comme les memoires ROM du moniteur ou des canaux utilises entree/sortie. 
En general ceci signifie que \aexpr1 \ sera dans l'etendue a max, ou max est determine par la 
taille de la memoire de I'ordinateur. Par exemple sur un APPLE II de 16 K de memoire, max est 
16384. Si APPLE II a 32 K de memoire, max est 32768; et si APPLE II a 48 K de memoire max 
est 49152. 

De nombreux emplacements de memoire contiennent une information necessaire au 
fonctionnement du systeme ordinateur. Une instruction POKE a ces emplacements peut alterer 
I'exploitation du systeme ou de votre programme ou introduire des perturbations dans 
APPLESOFT. 
WAIT: imm & dif 
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WAIT 



WAIT aexprl, aexpr2 f, aexpr3] 

permet a I'utilisateur d'inserer une pose conditionnelle dans un programme. Seul reset peut 
interrompre une instruction WAIT. 

\aexpr 1 \ est I'adresse de I'emplacement de memoire; elle doit etre dans I'etendue -65535 a 
65535 pour eviter le message 7ILLEGAL QUANTITY ERROR. En pratique, \aexprl \ se limite 
habituellement a I'etendue des adresses correspondant aux emplacements ou il existe des 
dispositifs a memoire valide, de a la valeur maxima de HIMEM dans votre ordinateur. Voir 
HIMEM et POKE pour plus de details. On peut utiliser des adresses equivalentes positives et 
negatives. 

\aexpr2 \ et \aexpr3 \ doivent etre dans I'etendue a 255, en decimal. Lorsque I'instruction 
WAIT s'execute, ces valeurs sont converties en nombres binaires dans I'etendue a 
111111111. 

Si \aexprl \ et \aexpr2 \ sont seules specifiers, chacun des huit bits du contenu binaire de 
I'emplacement aexprl est additionne logiquement avec le bit correspondant de I'equivalent 
binaire de \aexpr2. \ Pour chaque bit, ceci donne un a moins que les deux bits correspondants 
ne soient de valeur 1 . Si le resultat de ce processus est huit zeros, alors le test est repete. Si 
I'un des resultats est non-zero (ce qui signifie qu'au moins 1 bit de valeur 1 dans \aexpr2\ a 
correspondu a un bit correspondant de valeur 1, a I'emplacement \aexpr 1, \ I'instruction WAIT 
est terminee et le programme APPLESOFT reprend son execution a I'instruction suivante. 
WAIT \aexpl \, 7 fait que le programme s'arrete jusqu'a ce qu'au moins 1 des trois bits les plus a 
droite a I'emplacement \aexpr 1 \ ait la valeur 1 . 

WAIT aexprl ,0 
fait que le programme s'arrete definitivement. 

Si les trois parametres sont specifies, alors I'instruction WAIT agit comme suit: premierement 
chaque bit du contenu binaire de I'emplacement \aexprl \ est compare, dans une operation 
logique OU exclusive (instruction XOR) au bit correspondant de I'equivalent binaire de \aexpr3. \ 
Un bit de valeur 1 dans \ aexpr3 \ donne un resultat qui est I'inverse du bit correspondant de 
I'emplacement aexpr 1 (un 1 devient un zero, un zero devient un 1). Un bit de valeur zero dans \ 
aexpr 3 \ donne un resultat qui est le meme que le bit correspondant a I'emplacement aexpr 1. 
Si \aexpr 3 \ est justement zero, la portion XOR n'a pas d'effet. 

Deuxiemement, chaque resultat est additionne logiquement (AND) avec le bit correspondant de 
I'equivalent binaire de aexpr 2. Si le resultat final est huit zeros, le test est repete. S'il y a un 
result non zero, I'instruction WAIT est terminee et I'execution du programme APPLESOFT se 
continue a I'instruction suivante. 

Une autre fagon de regarder I'instruction WAIT: son objet est de tester les contenus des 
emplacements \aexpr 1 \ pour voir si I'un quelconque de certains bits a la valeur un ou I'un 
quelconque de certains autres bits a la valeur 0. Chacun des huit bits de I'equivalent binaire de 
\aexpr 2 \ indique si vous etes ou non interesse au bit correspondant a I'emplacement \aexpr 1 \: 
la valeur 1 signifie que vous etes interesse la valeur signifie que vous devez ignorer ce bit. 
Chacun des huit bits de I'equivalent binaire de \ aexpr 3 \ indique quel etat vous attendez 
(WAIT) pour le bit correspondant a I'emplacement \ aexpr 1 \: la valeur 1 signifie que le bit doit 
avoir la valeur 0, la valeur signifie que le bit doit avoir la valeur 1 . Si I'un quelconque des bits 
pour lesquels vous avez indique etre interesse (par un 1 dans le bit correspondant de \ aexpr 2 \ 
)correspond a I'etat que vous avez specifie pour ce bit (au moyen du bit correspondant de 
\aexpr 3 \) I'instruction WAIT est terminee. Si \aexpr 3 \ est omis, sa valeur par defaut est 
0. 

Par exemple: 

WAIT aexpr t, 255,0 signifie une pause jusqu'a ce qu'au moins un de huit bits qui se 

trouvent a I'emplacement aexpr 1 ait la valeur 1 . 
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WAIT aexprl, 255 



identique a I'exemple ci-dessus, en exploitation, 



WAIT aexprl ,255,255 



WAIT aexprl, 1,1 



WAIT aexpr 1,3,2 



signifie une pause jusqu'a ce qu'au moins un des huit bits qui se 
trouvent a I'emplacement aexpr 1 ait la valeur 

signifie une pause jusqu'a ce que le bit le plus a droite qui se trouve a 
I'emplacement aexprl ait la valeur 0, independamment de la valeur des 
autres bits. 

signifie une pause jusqu'a ce que soit le bit le plus a droite a 
I'emplacement aexpr I ait la valeur 1 soit le bit a gauche du a droite ait 
la valeur 0, soit que les deux conditions existent. 



Le programme suivant s'arrete jusqu'a ce que vous tapiez un caractere quelconque dont le code 
ASCII (voir appendice K) soit pair 

100 POKE -16368, : REM KEYBOARD STROBE (HIGH BIT) 

105 REM PAUSE UNTIL KEYBOARD STROBE IS SET BY ANY KEY. 

110 WAIT -16384, 128: REM WAIT UNTIL HIGH BIT IS ONE. 

115 REM PAUSE SOME MORE UNTIL KEY STRUCK IS EVEN. 

1 20 WAIT -1 6384, 1,1 : REM WAIT UNTIL LOW BIT IS ZERO. 

130 PRINT "EVEN" 

140 GOTO 100 



CALL 

CALL: imm & dif 
CALL aexpr 

amene I'execution du sous-programme en langage machine qui se trouve I'emplacement 
memoire dont I'adresse decimale est specifiee par \aexpr\. 

\ aexpr \ doit etre dans I'etendue -65535 a 65535, sinon il y a affichage du message 7ILLEGAL 
QUANTITY ERROR 

En pratique \aexpr\ se limite habituellement a I'etendue des adresses pour lesquelles il existe 
des dispositifs a memoire valide, de zero a la valeur maxima de HIMEM sur votre ordinateur. 
Voir HIMEM et POKE pour tous details. 

On peut utiliser de fagon interchangeable les adresses equivalentes positives et negatives. Par 
exemple "CALL-936" et "CALL 64600" sont identiques. 

L'appendice J contient des exemples de I'utilisation de CALL 

HIMEM: 

HIMEM: imm& dif 
HIMEM: aexpr 

Positionne I'adresse de I'emplacement en memoire le plus eleve disponible pour un programme 
BASIC, y compris les variables. S'utilise pour proteger la zone de memoire situee au-dessus de 
cette adresse, pour les donnees, les graphiques ou les routines en langage machine. 

\aexpr \ doit etre dans I'etendue -65535 a 65535, les deux limites comprises, pour eviter le 
message 

7ILLEGAL QUANTITY ERROR 
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Toutefois, les programmes ne peuvent pas s'executer de fagon fiable a moins qu'il n'y ait une 
memoire physique appropriee aux emplacements specifies par toutes les adresses jusque et y 
compris \ aexpr \. 

En general la valeur maxima de aexpr est determinee par I'importance de la memoire de 
I'ordinateur. Par exemple sur un APPLE II a 16 K de memoire, \ aexpr \ serait 16384 ou moins. 
Si APPLE II a 32 K de memoire aexpr pourrait aller jusque 32768; et si APPLE II a 48 K de 
memoire, \aexpr \ pourrait aller jusque 491 52. 

Normalement, APPLESOFT positionne automatiquement HIMEM a I'adresse de memoire la 
plus elevee disponible dans I'ordinateur de I'utilisateur si APPLESOFT est appele en premier 
lieu. 

La valeur actuelle de HIMEM est enregistree aux emplacements de memoire 116 et 115 
(decimal). Pour voir la valeur actuelle de HIMEM, tapez 
PRINT PEEK (116)*256 + PEEK (115) 

Si HIMEM positionne une adresse de memoire la plus elevee qui soit inferieure a celle 
positionnee par LOMEM, ou qui ne laisse pas suffisamment de memoire disponible pour 
I'execution du programme, on obtient le message 
?OUT OF MEMORY ERROR 

\aexpr\ peut etre dans I'etendue croissante a 65535, ou dans I'etendue equivalente croissante 
-65535 a -1. On peut utiliser de fagon interchangeable les valeurs equivalentes positives et 
negatives. 

HIMEM n'est pas remis a I'etat initial par CLEAR, RUN, NEW, DEL, par le fait de modifier ou 
d'ajouter une ligne de programme, ou par reset. HIMEM est remis a I'etat initial par reset Ctrl B 
return, qui efface egalement tout programme enregistre. 

LOMEM: 

LOMEM: imm& dif 
LOMEM: aexpr 

positionne I'adresse de I'emplacement de memoire le plus faible disponible pour un programme 
BASIC. C'est habituellement I'adresse de I'emplacement de memoire de demarrage pour la 
premiere variable BASIC. Normalement APPLESOFT positionne automatiquement LOMEM a la 
fin du programme en cours, avant d'executer le programme. Ces instructions permettent de 
proteger les variables provenant des graphiques haute resolution dans les ordinateurs a grande 
capacite de memoire. 

\ aexpr \ doit etre dans I'etendue -65535 a 65535, les deux bornes comprises, pour eviter le 
message ? 

ILLEGAL QUANTITY ERROR. 

Toutefois si LOMEM est positionne au-dessus de la valeur en cours de HIMEN le message 

? OUT OF MEMORY ERROR est affiche. Ceci signifie que aexpr doit etre inferieur a 
la valeur maxima qui peut etre positionnee par HIMEM (voir HIMEM pour une discussion de sa 
valeur maxima) 

Si LOMEM est positionne a une valeur inferieure a I'adresse de I'emplacement en memoire le 
plus eleve occupe par le systeme d'exploitation en cours (plus tout programme enregistre 
actuellement), le message 

? OUT OF MEMORY ERROR 
est a nouveau affiche. Ceci impose une limite inferieure absolue sur\aexpr\ d'environ 2051 pour 
APPLESOFT en ROM 

LOMEM est remis a I'etat initial par NEW, DEL et en ajoutant ou modifiant une ligne de 
programme. 

LOMEM est remis a I'etat initial par reset Ctrl B qui efface egalement tout programme enregistre 
en memoire. II n'est pas remis a I'etat initial par RUN, reset Ctrl C return reset 0G return. 
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La valeur actuelle de LOMEM est enregistree aux emplacement LOMEM de memoire 106 et 
105 (decimal). Pour voir la valeur actuelle de LOMEM, tapez 
PRINT PEEK (106)*256 + PEEK (105) 

Une fois positionne, a moins d'etre tout d'abord remis a I'etat initial par I'une des instructions ci- 
dessus, LOMEM peut etre positionne a une nouvelle valeur uniquement si la nouvelle valeur est 
superieure (en memoire) a I'ancienne. Un essai de positionner LOMEM a une valeur inferieure a 
la valeur actuellement en effet donne le message 
? OUT OF MEMORY ERROR 

Le fait de changer LOMEM pendant le cours d'un programme peut risquer de rendre 
indisponible certains supports ou portions du programme, de sorte que ce programme ne 
continuera pas a s'executer correctement. 

On peut utiliser de fagon interchangeable des adresses equivalentes positives et negatives. 

USR 

USR: imm& dif 
USR (aexpr) 

Cette fonction envoie \aexpr \ dans un sous-programme de langage machine. 
L'argument aexpr est evalue et place dans I'accumulateur a point decimal flottant 
(emplacements $9D a $A3) et il s'etablit un JSR decimal flottant (emplacements $9D a $A3) et il 
s'etablit un JSR renvoyant a I'emplacement $0A 

Les emplacements $0A a $0C doivent contenir un JMP renvoyant a I'emplacement de debut du 
sousprogramme de langage machine. La valeur obtenue pour la fonction est placee dans 
I'accumulateur a point decimal flottant. 

Pour obtenir un entier de 2 octets a partir de la valeur qui se trouve dans I'accumulateur a point 
decimal flottant, votre sousprogramme doit etablir un JSR renvoyant a $E1 0C. Lorsqu'on 
I'obtient, la valeur entiere se trouvera aux emplacements $A0 (octet d'ordre superieur) et $A1 
(octet d'ordre inferieur). 

Pour convertir un resultat entier en son equivalent a point decimal flottant, de fagon que la 
fonction puisse fournir cette valeur, placez rentier de 2 octets dans les registres A (octet d'ordre 
superieur) et Y octet d'ordre inferieur). Puis etablissez un JSR renvoyant a $E2F2. Lorsqu'on 
I'obtient, la valeur a point decimal flottant se trouvera dans I'accumulateur a point decimal 
flottant. 

Pour revenir a APPLESOFT, etablissez un RTS. 

Voici un programme sans importance, utilisant la fonction USR, simplement pour vous en 
montrer le format. 

jreset 

* 0A:4C 00 03 return 

* 0300: 60 return 

* Ctrl C return 

] PRINT USR(8)*3 

24 

A I'emplacement $0A nous plagons un JMP (code 4C) renvoyant a I'emplacement $300 (octet 
d'ordre inferieur d'abord, puis d'ordre superieur). A I'emplacement $300, nous plagons un RTS 
(code 601. Revenant a APPLESOFT, lorsque Ton a rencontre USR (81, l'argument 8 a ete mis 
en place dans I'accumulateur, le moniteur a etabli un JSR renvoyant a I'emplacement S0A ou il 
a trouve un JMP renvoyant a $300. A I'emplacement $300 il a trouve un RTS qui I'a renvoye a 
APPLESOFT. La valeur obtenue etait justement la valeur d'origine 8 qui se trouvait dans 
I'accumulateur, valeur que APPLESOFT a alors multiplied par 3 pour obtenir 24. 
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CHAPITRE 4 

Instructions d' edition et instructions relatives au format 

Dans le chapitre 3. voir egalement Ctrl C. 

42 LIST 

43 DEL 

43 REM 

44 VTAB 
44 HTAB 

44 TAB 

45 POS 
45SPC 

46 HOME 
46 CLEAR 

46 FRE 

47 FLASH, INVERSE et NORMAL 
47 SPEED 

47 esc A, esc B, esc C et esc D 

48 repeat 

48 fleche a droite et fleche a gauche, 
48 Ctrl X 
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LIST 



LIST: imm & dif 

LIST [linenuml I f- Iinenum2] 
LIST [linenuml] f, Iinenum2] 

S'il n'y a ni linenuml ni Iinenum2, avec ou sans delimiteur, la totalite du programme est affichee 
sur I'ecran et s'il y a linenuml sans delimiteur ou linenuml =linenum2, alors c'est seulement la 
ligne numerotee linenuml qui est affichee. S'il y a linenuml et un delimiteur, alors le programme 
est affiche depuis la ligne numerotee linenuml jusqu'a la fin. S'il y a un delimiteur et Iinenum2, 
alors le programme est affiche depuis le debut jusqu'a la ligne numerotee Iinenum2. S'il y a a la 
fois linenuml, un delimiteur et Iinenum2, le programme est affiche depuis la ligne numerotee 
linenuml jusqu'a la ligne numerotee Iinenum2, comprise. 

Si plus d'une ligne doit etre affichee, si la ligne numerotee linenuml dans I'instruction LIST 
n'apparaTt pas dans le programme, I'instruction LIST utilisera la ligne de numero immediatement 
superieur qui apparait dans le programme. Si la ligne est numerotee Iinenum2 dans I'instruction 
LIST, n'apparaTt pas dans le programme, I'instruction LIST utilisera la ligne de numero 
immediatement inferieur qui apparait dans le programme. 

Les instructions suivantes affichent toutes la totalite du programme. 
LIST LIST [,l-] LIST [J-] 

L'instruction 

LIST linenum, affiche depuis la ligne de numero linenum jusqu'a la fin du 
programme 

LIST, Affiche la totalite du programme puis donne le message 7SYNTAX ERROR. 

APPLESOFT simule vos lignes de programme avant de les enregistrer, en enlevant les espaces 
non necessaires dans le processus. Lors de I'affichage, APPLESOFT reconstitue les lignes de 
programmes simulees, en ajoutant des espaces selon ses propres regies. Par exemple: 

10 C =+5/-6:B=-5 devient 

10C=+5/-6:B=-5 une fois affiche 

LIST utilise une largeur de ligne variable et des reculs sur I'alignement variables. Ceci peut 
constituer un probleme lorsque vous essayez d'editer ou de copier une instruction affichee. Pour 
obliger LIST a abandonner son format avec des espaces supplementaires, effacez I'ecran et 
reduisez la fenetre de texte a la largeur 33 (maximum). 

HOME 

POKE 33,33 




APPLESOFT ramene une ligne a 239 caracteres puis I'instruction LIST ajoute liberalement des 
espaces. Vous pouvez done entrer de nombreux caracteres supplementaires en abandonnant 
les espaces lorsque vous les tapez - LIST les ajoute ensuite. Si vous essayez de copier votre 
instruction ainsi etendue a partir de I'ecran, ceci se traduit par le fait qu'elle est a nouveau 
ramenee a 239 caracteres, y compris les espaces ajoutes par LIST. 
L'affichage est abandonne par ctrl C. 
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DEL 



DEL: imm & dif 

DEL linenuml , Iinenum2 

DEL efface I'etendue des lignes allant de linenuml a Iinenum2, comprises. Si linenuml n'est 
pas un numero existant de ligne du programme, c'est le numero de ligne immediatement 
superieur existant dans le programme que Ton utilise au lieu de linenuml ; si Iinenum2 n'est pas 
un numero de ligne existant dans le programme, c'est le numero de ligne immediatement 
inferieur existant qui est utilise. 

Si vous ne suivez pas le format habituel, I'instruction DEL donne les resultats variables suivants: 
Syntaxe resultat 
DEL 7SYNTAX ERROR 

DEL, 7SYNTAX ERROR 

DEL ,b 7SYNTAX ERROR 

DEL -a[,b] 7SYNTAX ERROR 

DEL 0,b efface la ligne zero, independamment de la valeur de b. 

DEL 1,-b est ignoree, meme si le numero de ligne le plus faible du programme 
est zero. 

DEL a,-b 7SYNTAX ERROR si a est superieur au numero de ligne le plus faible 
du programme, a moins que le numero de ligne le plus faible du 
programme ne soit zero et que a ne soit un. 
DEL a,-b est ignore si a n'est pas zero et si I'unique ligne de programme est la 
ligne no zero. 



DEL a,-b est ignore si a n'est pas zero et si a est inferieur ou egal au numero de 
ligne le plus faible du programme. 




DEL a[,] est ignore 



DEL a,b est ignore si a n'est pas zero et si a est superieur a b 

Lorsqu'on I'utilise en execution differee, DEL travaille comme indique ci-dessus, puis arrete 
I'execution. CONT n'a pas d'action dans cette situation. 

REM 

REM imm & dif 
REM ( caractere I" ) 

Cette instruction sert a permettre I'insertion dans un programme d'un texte de toute sorte. On 
peut y inclure tous les caracteres, y compris des separateurs destructions et des blancs. Leur 
signification habituelle est ignoree. Une instruction REM ne se termine que par return. 

Lorsque les instructions REM sont listees, APPLESOFT insere un espace supplemental apres 
REM, independamment du nombre d'espaces tapes apres REM par I'utilisateur. 
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VTAB 



VTAB imm & dif 
VTAB aexpr 

Deplace le curseur pour I'amener a la ligne qui se trouve a \aexpr \ lignes plus bas sur I'ecran. 
La ligne superieure est la ligne 1; la ligne inferieure est la ligne 24. Cette instruction peut 
impliquer le deplacement du curseur vers le haut ou vers le bas, mais jamais vers la droite ou 
vers la gauche. 

Des arguments qui se trouvent en dehors de I'etendue 1 a 24, font apparaTtre le message ? 
ILLEGAL QUANTITY ERROR 

VTAB utilise des mouvements absolus, relatifs uniquement a la ligne superieure et a la ligne 
inferieure de I'ecran elle ignore la fenetre de texte. En mode graphique, VTAB va deplacer le 
curseur dans la zone graphique de I'ecran. Si VTAB deplace le curseur vers une ligne qui se 
trouve en-dessous de la fenetre de texte, toute I'impression ulterieure s'effectue sur cette ligne. 

HTAB 

HTAB imm & dif 
HTAB aexpr 

Supposons que la ligne sur laquelle le curseur est situe presente 255 positions, de 1 a 255. 
Quelle que soit la largeur de fenetre de texte, que vous pouvez avoir definie, les positions 1 a 
40, sont sur la ligne en cours, les positions 41 a 81 sont sur la ligne immediatement en dessous 
et ainsi de suite. HTAB deplace le curseur pour I'amener a la position qui se trouve a \aexpr\ 
positions a partir du bord gauche de la ligne d'ecran en cours. Les deplacements definis par 
VTAB sont relatifs a la marge gauche de la fenetre de texte, mais independants de la largeur de 
la ligne. HTAB peut deplacer le curseur a I'exterieur de la fenetre de texte, mais uniquement 
assez loin pour imprimer (PRINT) un caractere. Pour placer le curseur dans la position la plus a 
gauche de la ligne en cours, utilisez HTAB 1 . 

HTAB deplace le curseur a la position 256. 

Si \ aexpr \ est negatif ou superieur a 255, il apparatt le message 

7ILLEGAL QUANTITY ERROR 
Notez que les structures de HTAB et VTAB ne sont pas paralleles, en ce sens qu'une valeur de 
HTAB allant au-dela du bord droit de I'ecran n'amene pas le message 

7ILLEGAL QUANTITY ERROR 
mais fait que le curseur saute a la ligne immediatement inferieure et tabule 

(aexpM)MOD 40)+ 1. 

TAB 

TAB imm & dif 
TAB (aexpr) 

TAB doit etre utilise dans une instruction PRINT et \aexpr\ doit etre mis entre parentheses. TAB 
deplace le curseur pour I'amener a la position qui se trouve \ aexpr \ positions d'impression a 
partir de la marge de gauche de la fenetre du texte si aexpr est superieur a la valeur de la 
position en cours du curseur par rapport a la marge de gauche. Si \ aexpr \ est inferieur a la 
valeur de position en cours du curseur, alors le curseur n'est pas deplace - TAB ne deplace 
jamais le curseur vers la gauche (utilisez HTAB dans ce but) 

Si TAB deplace le curseur au-dela de la limite la plus a droite de la fenetre du texte, le curseur 
est envoye a la limite la plus a gauche -e la ligne immediatement en-dessous de la fenetre de 
texte et I'espacement continue a partir de la 
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TAB (0) place le curseur a la position 256. 

\aexpr \doit etre dans I'etendue a 255, sinon il apparaTt le message 

7ILLEGAL QUANTITY ERROR 
TAB n'est analyse comme mot reserve que si le caractere suivant autre qu'un espace est 
une parenthese gauche. 



POS 

POS imm & dif 
POS (expr) 

donne la position horizontale actuelle du curseur sur I'ecran, par rapport au bord gauche de la 
fenetre de texte. Si le curseur est sur le bord gauche, on obtient 0. Bien que expr n'ait ici comme 
role que de separer les parentheses, elle est neanmoins evaluee, et ne doit done pas etre 
illegale. Tout ce qui peut s'interpreter comme un nombre, un nom de chaTne ou un nom de 
variable peut s'utiliser pour expr. Si expr est un ensemble de caracteres qui ne peut pas etre un 
nom de variables, les caracteres doivent se trouver entre guillemets. 

Notez que pour HTAB et TAB les positions sont numerotees a partir de 1 , tandis que pour POS 
et SPC, elles sont numerotees a partir de 0. Done 

PRINT TAB (23); POS(0) 
amene I'impression de 22, alors que 

PRINT SPC (23); POS(0) 
amene I'impression de 23. 



SPC 

SPC imm & dif 
SPC (aexpr) 

doit etre utilise dans une instruction PRINT et aexpr doit se trouver entre parentheses. Cette 
instructions introduit des espacements definis par \ aexpr \ entre I'item precedemment imprime 
(ou par defaut le bord gauche de la fenetre de texte) et le nouvel item a imprimer, si I'instruction 
SPC est concatenee avec les items precedents et suivants par juxtaposition ou par intervention 
de point et virgule. SPC(O) n'introduit aucun espacement. 

\aexpr\ doit etre dans I'etendue a 255 compris sinon il apparaTt le message 

? ILLEGAL QUANTITY ERROR 
Toutefois, une instruction SPC(aexpr) peut etre concatenee a une autre sous la forme 

PRINT SPC (250)SPC(139)SPC(255) 
et ainsi de suite, pour fournir des espacements positifs de grandeur arbitraire. 

Notez que tandis que HTAB amene le curseur a une position absolue de I'ecran par rapport au 
bord gauche de la fenetre de texte, SPC(aexpr) deplace le curseur d'un certain nombre 
d'espaces a partir de I'item precedemment imprime. Cette nouvelle position peut etre n'importe 
ou dans la fenetre du texte, selon I'emplacement de I'item precedemment imprime. 
Un deplacement au-dela de la limite la plus a droite de la fenetre de texte amene le 
deplacement ou I'impression a reprendre au bord gauche de la ligne immediatement en- 
dessous sur la fenetre du texte. 

Dans le cas d'impression dans les champs de tabulateur, cet espacement peut se faire a 
I'interieur d'un champ de tabulateur ou en passant dans un autre champ de tabulateur ou peut 
occuper un champ de tabulateur par lui-meme. 




Si \aexpr \ est un reel, il est converti en un entier. 

SPC est analyse comme mot reserve uniquement si le caractere suivant autre qu'un 
espacement est une parenthese gauche. 

HOME 

HOME imm & dif 
HOME 

Pas de parametres. Amene le curseur a la position superieure gauche de I'ecran a I'interieur de 
la fenetre de defilement et efface tout le texte qui se trouve a I'interieur de la fenetre. Cette 
instruction est identique a "CALL-936" et a "esc @ return". 

CLEAR 

CLEAR imm & dif 
CLEAR 

Pas de parametres. Ramene a la valeur zero toutes les variables, les tableaux et les chaTnes. 
Ramene a I'etat initial les pointeurs et les registres. 

FRE 

FRE imm & dif 
FRE (expr) 

FRE indique la valeur de la memoire (en octets) dont I'utilisateur peut encore disposer. Vous 
pouvez quelquefois disposer de davantage de memoire que ce que vous pensez, car 
APPLESOFT n'enregistre qu'une seule fois les chaTnes dupliquees. C'est-a-dire que si 
A$='PIPPIN' et B$="PIPPIN", la chaTne "PIPPIN" ne sera enregistree en memoire qu'une seule 
fois. 

Si le nombre d'octets libres en memoire depasse 32767, FRE(expr) fournit un nombre negatif. 
En ajoutant 65536 a ce nombre, vous obtiendrez le nombre effectif d'octets libres en memoire. 
FRE (expr) fournit le nombre d'octets qui subsistent en-dessous de I'emplacement 
d'enregistrement des chaTnes et au-dessus de I'emplacement des tableaux numeriques HIMEM: 
peut etre positionne a une valeur aussi elevee que 65535 mais si HIMEM: est positionne au- 
dela de I'emplacement de memoire RAM le plus eleve qui se trouve dans votre APPLE, 
I'instruction FRE peut donner un nombre n'ayant guere de signification et depassant la capacite 
de memoire de I'ordinateur (voir HIMEM: et POKE pour une discussion des limites de la 
memoire). 

Si les contenus d'une chaTne sont modifies pendant le cours d'un programme, (par exemple A$ 
qui etait egal a "cat" devient A$="dog"), APPLESOFT n'elimine pas "cat", mais ouvre 
simplement un nouveau fichier pour "dog '. II en resulte qu'une quantite d'anciens caracteres 
viennent doucement remplir par le bas, depuis HIMEM: jusqu'a la partie superieure de I'espace 
des tableaux. APPLESOFT va automatiquement faire le menage lorsque ces anciennes 
donnees arrivent dans I'espace libre des tableaux, mais si vous utilisez une partie de I'espace 
libre pour des programmes de langage machine ou comme memoire intermediate de page 
haute resolution, ils peuvent etre demolis. 

L'utilisation periodique dans votre programme d'une instruction de la forme : 
X = FRE (0) 

oblige le menage a se faire et evite ces risques. 

Bien que expr ne soit utilise que pour separer les parentheses, il est evalue et ne doit done pas 
etre illegal. 
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FLASH INVERSE NORMAL 



FLASH imm & dif 
INVERSE imm & dif 
NORMAL imm & dif 

Ces trois instructions s'utilisent pour positionner les modes sortie video. Elles n'utilisent pas de 
parametres et n'affectent pas I'affichage des caracteres que vous tapez sur I'ordinateur ni les 
caracteres qui se trouvent deja sur I'ecran. 

FLASH positionne le mode video en "clignotement" qui fait que les informations de sortie 
provenant de I'ordinateur sont alternativement representees sur I'ecran en blanc sur fond noir 
puis inversement en noir sur fond blanc. 

INVERSE positionne le mode video de fagon que les informations de sortie de I'ordinateur 
s'impriment en lettres noires sur fond blanc. 

NORMAL positionne le mode en lettres blanches sur fond noir comme habituellement a la fois 
pour les entrees et les sorties. 



SPEED 

SPEED imm & dif 
SPEED = aexpr 

definit la vitesse a laquelle les caracteres doivent etre envoyes sur I'ecran ou sur d'autres 
dispositifs d'entree/ sortie. La vitesse la plus faible est 0. La vitesse la plus rapide est 255. Des 
valeurs en dehors de cette etendue 

7ILLEGAL QUANTITY ERROR du message 

ESC 

esc A imm seulement (edition seulement) 
esc B imm seulement (edition seulement) 
esc C imm seulement (edition seulement) 
esc D imm seulement (edition seulement) 

La touche escape, etiquetee "ESC", peut s'utiliser en liaison avec les touches de lettres A ou B 
ou C ou D pour deplacer le curseur: pour deplacer le curseur d'un espacement, enfoncez 
d'abord la touche escape puis relachez la touche escape et enfoncez la touche lettre 
appropriee. 



Instruction deplace le curseur d'un espacement vers 

esc A la droite 

esc B la gauche 

esc C le bas 

esc D le haut. 



Ces instructions escape n'affectent pas les caracteres au-dessus desquels passe le curseur: 
ces caracteres subsistent a la fois sur I'ecran TV et en memoire. Par elles-memes, les 
instructions escape n'affectent pas non plus la ligne de programme en cours de frappe. 

Pour modifier une ligne de programme, affichez cette ligne sur I'ecran (instruction LIST) et 
utilisez les instructions escape pour deplacer le curseur de fagon qu'il se trouve directement sur 
le veritable premier caractere de la ligne affichee. Puis utilisez la touche de fleche a droite et la 
touche REPT pour recopier les caracteres qui apparaissent sur I'ecran, en tapant un caractere 
different chaque fois que le curseur se trouve sur un caractere que vous desirez changer. Si 
vous n'avez pas affiche la ligne a I'aide de I'instruction list, ne copiez pas le caractere (1 1 qui 
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apparaTt au debut de cette ligne. Enfin, enfoncez la touche RETURN pour enregistrer en 

memoire la ligne ou I'executer. 

repeat imm seulement (edition seulement) 

La touche repeat est la touche etiquetee "REPT". Si vous maintenez enfoncee la touche repeat 
tout en enfongant une touche de caractere, ce caractere sera repete. La premiere fois que vous 
enfoncez la touche repeat seule, elle repete le dernier caractere tape. 

Fleche 

Fleche a droite imm seulement (edition seulement) 
Fleche a gauche imm seulement (edition seulement) 

La touche fleche a droite deplace le curseur vers la droite. Au fur et a mesure que le curseur se 
deplace, chaque caractere sur lequel il passe sur I'ecran est copie dans la memoire de APPLE 
II, exactement comme si vous aviez tape le caractere. Cette touche s'utilise, avec la touche 
repeat, pour eviter de devoir retaper une ligne entiere qui ne demande que des changements 
mineurs. 

La touche fleche a gauche deplace le curseur vers la gauche. Chaque fois que le curseur se 
deplace vers la gauche, un caractere est efface dans la ligne de programme que vous etes en 
train de taper quel que soit le caractere sur lequel le curseur se deplace. L'ecran est ignore par 
cette instruction et rien n'est change sur I'ecran. 




A moins que vous ne soyez en train de taper une ligne pour laquelle vous n'avez pas encore 
enfonce la touche return, la touche fleche a gauche n'a pas de caracteres de la ligne de 
programme en cours a effacer. Dans ce cas, son utilisation va amener le caractere (1 I a 
apparaTtre dans la colonne de la ligne immediatement inferieure, suivi du curseur. C'est 
pourquoi le curseur, frequemment, ne peut pas etre amene a la colonne de I'ecran TV en 
utilisant la touche fleche a gauche. Pour chaque deplacement il faut effacer un caractere de la 
ligne de programme en cours. Pour avoir des deplacements purs, sans effacer ni copier, voir les 
instructions 



ctrlX 

Ctrl X imm seulement 

Demande a APPLE II d'ignorer la ligne actuellement en cours de frappe, sans effacer toute ligne 
precedente de meme numero de ligne. Une barre oblique inverse ( \ 1 est affichee a la fin de la 
ligne a ignorer et le curseur saute a la colonne de la ligne suivante. Cette instruction peut 
egalement s'utiliser durant une reponse a une instruction INPUT. 
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CHAPITRE 5 

Tableaux et chaines 



50 DIM 

51 LEN 
51 STR $ 
51 VAL 
51 CHR$ 

51 ASC 

52 LEFT $ 

52 RIGHT $ 

53 MID$ 

53 STORE et RECALL 
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DIM 



DIM imm & dif 

DIM var indices (i, var indice )1 

Lorsqu'une instruction DIM s'execute, elle reserve la place d'un tableau du nom de var. Deux 
octets de memoire sont utilises pour enregistrer en memoire un nom de tableau de variables, 
deux pour la dimension du tableau, un pour le nombre de dimensions, et deux pour chaque 
dimension. Comme on le discute ci-dessous, I'importance de la place allouee pour les elements 
d'un tableau depend du type de tableau. 

Les indices vont de a \subcript \. Le nombre d'elements d'un tableau a n dimensions est 
(\subscript1 \ + 1 )*(\subscript2 \ + 1 )* . . . *(\subscriptn \ + 1 1 . 

Par exemple DIM SHOW (4,5,3) reserve la place de 5*6*4 elements (120 elements). Des 
elements typiques sont 

SHOW (4,4,11 

SHOW (0,0,2) 

Le nombre maximum de dimensions pour un tableau est 88, meme si chaque dimension peut 
ne contenir qu'un seul element. 
DIM A(0,0, . . .01 , ou il y a 89 zeros donne un message 
? OUT OF MEMORY ERROR 

mais 

DIM A(0,0, . . . 0) ou il y a 88 zeros ne le donne pas 

En pratique toutefois, la dimension des tableaux est souvent limitee bien plus par I'importance 
de la memoire disponible. Chaque element entier d'un tableau occupe deux octets (16 bits) en 
memoire. Chaque element reel d'un tableau occupe 5 octets (40 bits) en memoire. Les variables 
chaines d'un tableau utilisent 3 octets pour chaque element (un pour la longueur, deux pour un 
pointeur d'emplacement), enregistre en memoire sous forme d'un tableau d'entiers si le tableau 
est dimensionne. Du fait que les chaines elles-memes sont enregistrees en memoire par le 
programme, elles occupent encore 1 octet de plus par caractere. 

Si un element sous forme de tableau est utilise dans un programme avant que cette variable ne 
soit dimensionnee, APPLESOFT affecte un indice maximum de dix pour chaque dimension 
dans les indices de I'element. 

Le fait d'utiliser une variable dont I'indice est superieur au maximum designe ou qui demande un 
nombre de dimensions different de celui specifie dans une instruction DIM amene I'apparition du 
message 

? BAD SUBSCRIPT ERROR 

Si le programme dimensionne un tableau qui au meme nom qu'un tableau precedemment 
dimensionne (meme s'il a ete dimensionne par defaut), il apparait le message 
? REDIM'D ARRAY ERROR 

Les differentes chaines d'un tableau de chaines ne sont pas dimensionnees mais croissent et 
decroissent selon necessite. L'instruction 

WARD $151= "ABCDE" 
cree une chaine de longueur 5. L'instruction 

WARD $15) = "" 

supprime la place reservee a la chaine WARD $151. Une chaine peut contenir au maximum 
255 caracteres. 

Les elements du tableau sont remis a zero lors de I'execution des instructions RUN ou CLEAR. 
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LEN 

LENimm&dif 
LEN (sexpr) 

Cette fonction indique le nombre de caracteres qui se trouvent dans une chaine, entre et 255. 
Si I'argument est une concatenation de chaTnes dont la longueur combinee est superieure a 
255, on obtient le message 

? STRING TOO LONG ERROR 

STR$ 

STR $ imm & dif 
STR $ (aexpr) 

Cette fonction convertit \aexpr\ en une chaine qui represents cette valeur. \aexpr\ est evalue 
avant d'etre converti en une chaine. STR $1 1 00 000 000 000) donne 1 E+ 1 1 . 
Si \aexpr \ depasse les limites des nombres reels, on obtient I'affichage du message 
? OVERFLOW ERROR 

VAL 

VAL imm & dif 
VAL (sexpr) 

Cette fonction essaie d'interpreter une chaine comme reel ou comme entier, en fournissant la 
valeur de ce nombre. 

Le premier caractere de la chaine doit etre un item possible dans un nombre (des- espaces 
blancs en tete sont acceptables) sinon c'est un zero qui est donne. Chaque caractere a la suite 
est egalement examine jusqu'a ce que Ton rencontre le premier caractere non numerique bien 
defini (les espaces blancs intermediates), les points decimaux, les signes + et - et E sont tous 
des caracteres numeriques possibles dans le contexte correct). Le premier caractere non 
numerique et tous les caracteres suivants sont ignores et la chaine jusqu'a ce point est evaluee 
comme un reel ou un entier. 

Si I'argument de VAL est une concatenation de chaines, comprenant plus de 255 caracteres, on 
regoit le message 

? STRING TOO LONG ERROR 
Si la valeur absolue du nombre fourni est superieure a 1 E38, ou si le numero contient plus de 
38 chiffres (y compris les zeros de queue), on obtient le message 
? OVERFLOW ERROR 

CHR$ 

CHR $ imm & dif 
CHR $ (aexpr) 

C'est une fonction qui donne le caractere ASCII qui correspond a la valeur aexpr. \aexpr\ doit 
etre entre et 255, inclusivement, sinon on obtient le message ? ILLEGAL QUANTITY ERROR 
Les nombres reels sont convertis en entiers. 

ASC 

ASC imm & dif 
ASC (sexpr) 

Cette fonction fournit un code ASCII (pas necessairement le nombre le plus faible) pour le 
premier 



caractere de \ sexpr V Les codes ASCII sur I'etendue 96 a 255 vont engendrer, sur I'ordinateur 
APPLE, des caracteres qui repetent ceux de I'etendue a 95. Par contre, bien que CHR $165) 
donne un A et que CHR $1 1 93) donne egalement un A, APPLESOFT ne reconnait pas les deux 
comme etant le meme caractere lors de I'utilisation d'operateurs logiques de chaines. 

Si c'est une chaine qui est I'argument, elle doit etre mise entre guillemets et les guillemets ne 
doivent pas etre compris dans la chaine. Si la chaine est une chaine nulle on obtient le 
message 

? ILLEGAL QUANTITY ERROR 




Un essai d'utiliser la fonction ASC sur ctrl@ se traduit par le message 
? SYNTAX ERROR 

LEFT 

LEFT $ imm & dif 
LEFT $ (sexpr, aexpr) 

Cette fonction donne les premiers (les plus a gauche) caracteres \aexpr\ de \sexpr V 

PRINT LEFT $(-APPLESOFT% 5) 
APPLE 

aucune partie de cette instruction ne peut etre omise. Si \aexpr \ < 1 ou \aexpr \ >255, alors on 
obtient le message 

? ILLEGAL QUANTITY ERROR 

Si \aexpr \ est un reel, il est converti en un entier. 

Si \aexpr\>LEN(sexpr), seuls les caracteres qui constituent la chaine sont fournis. Toute position 
supplemental est ignoree. 

Si "$" est omis dans le nom de I'instruction, APPLESOFT traite LEFT comme un nom de 
variable arithmetique et on obtient le message 
? TYPE MISMATCH ERROR 

RIGHT 

RIGHT $ imm & dif 
RIGHT $ (sexpr, aexpr) 

Cette fonction fournit les derniers (les plus a droite) caracteres \aexpr\ de \sexpr \ 

PRINT RIGHT $("APPLESOFT" + "ARE", 8) 
SOFTWARE 

Aucune partie de cette instruction ne peut etre omise. Si \aexpr\> = LEN (sexpr) alors RIGHT $ 
fournit la totalite de la chaine. Si \aexpr\ <1 or \aexpr\ >255, on obtient le message 
? ILLEGAL QUANTITY ERROR 

RIGHT $ (sexpr, aexpr) = MID $(aexpr, LEN(sexpr)+1-\aexpr\) 
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Si "$" est omis dans le nom de I'instruction, APPLESOFT traite RIGHT comme un nom de 
variable arithmetique et on obtient le message 
? TYPE MISMATCH ERROR 

MID 

MID $ imm & dif 

MID $ (sexpr, aexprl f, aexpr2]) 

MID $ appele avec deux arguments fournit la sous-chaine qui commence au caractere d'ordre 
\aexprl \ de \sexpr \ et qui va jusqu'au dernier caractere de \sexpr \. 

PRINT MID $("APPLESOFT", 3) 
PLESOFT 

MID$ (sexpr, aexpr)= RIGHT $(aexpr, LEN(sexpr)+ 1- \aexpr \) MID$ appele avec trois 
arguments fournit les \aexpr2\ caracteres de \sexpr\, commengant parle caractere d'ordre \aexpr 
I \ et continuant vers la droite. 

PRINT MID $("APPLESOFT", 3, 5) 
PLESO 

Si \aexprl \>LEN (sex r) alors MID$ fournit une chaTne nulle. Si \aexprl \+ \aexpr2\ depasse la 
longueur de \ sexpr \ (ou 255, la longueur maxima d'une chaTne quelconque), tout caractere 
supplemental est ignore. MID$(A$,255,255) fournit un caractere si LEN(A$)=255, sinon, c'est 
la chaTne nulle qui est fournie. 

Si soit \aexpr I \ soit \aexpr2 \ sont a I'exterieur de I'etendue 1 a 255 inclusivement, on obtient le 
message 

? ILLEGAL QUANTITY ERROR 

Si $ est omis dans le nom de I'instruction, APPLESOFT traite MID comme un nom de variable 
arithmetique et on obtient le message 
? TYPE MISMATCH ERROR 

STORE et RECALL 

STORE imm & dif 
RECALL imm & dif 

STORE avar 
RECALL avar 

Ces instructions memorisent et rappellent les tableaux qui se trouvent sur cassette. 

Les noms de tableaux ne sont pas memorises avec leurs valeurs de sorte qu'un tableau peut 
etre lu en utilisant un nom different de celui qui est utilise avec I'instruction STORE. 

Les dimensions du tableau nomme par I'instruction RECALL doivent etre identiques aux 
dimensions du tableau d'origine tel qu'il a ete memorise avec I'instruction STORE. Par exemple 
si un tableau dimensionne par DIM A(5,5,5) est memorise avec I'instruction STORE, on peut le 
rappeler dans un tableau dimensionne par DIM 13(5,5,51 . Le fait de ne pas en tenir compte se 
traduit par des nombres brouilles dans le tableau rappele, par des zeros supplementaires dans 
le tableau ou par le message ?OUT OF MEMORY ERROR 
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En general vous recevrez le message ?OUT OF MEMORY ERROR uniquement si le nombre 
total d'elements reserves pour le tableau rappele est insuffisant pour contenir tous les elements 
du tableau qui etaient memorises. 

DIM A (5,5,5) 

STORE A 

Sauvegarde 6*6*6 elements sur la bande en cassette. DIM B (5,35) 

RECALL B 
se traduit par le message 

ERR 

et par des nombres brouilles dans le tableau B mais I'execution du programme va se 
poursuivre. 

Par contre 

DIM B (5,25) 

RECALL B 
va donner I'affichage du message 
? OUT OF MEMORY ERROR 

et I'execution du programme va cesser. Dans ce cas le tableau B contenait 6*26 elements - trap 
peu d'elements pour contenir tous les elements du tableau A 

Si le tableau rappele au meme nombre de dimensions ([DIM A(,5,5,5) specifie un tableau de 
trois dimensions, chacune de 6 valeurs d'indice) que le tableau qui etait memorise, chacune des 
dimensions du tableau rappele peut avoir davantage de valeurs d'indice que la dimension 
correspondante du tableau memorise. Toutefois, il va en resulter des nombres brouilles dans le 
tableau rappele, a moins que ce soit la derniere dimension du tableau rappele qui possede 
davantage de valeurs d'indice que la derniere dimension du tableau memorise. Dans tous les 
cas vous trouverez des zeros supplementaires memorises dans les elements en exces du 
tableau rappele, mais ce n'est que dans le dernier cas que vous trouverez ces zeros la ou vous 
les attendiez. Apres avoir memorise un tableau avec 

DIM A (5,5,5) 

STORE A 
vous trouverez que 

DIM B (10,5,5) 

RECALL B 

ainsi que 

DIM B (5,10,5) 
RECALL B 

remplissent tous les deux le tableau B avec des nombres melanges en provenance du tableau 
A, tandis que 

DIM B (5,5,10) 

RECALL B 

marche bien avec des zeros dans les elements supplementaires du tableau B. 

Nous avons discute deux regies permettant de memoriser et de rappeler les tableaux d'un 
mome nombre de dimensions. 

1. Seule la derniere dimension du tableau rappele peut avoir davantage de valeurs d'indice que 
la derniere dimension du tableau memorise. 

2. Le nombre total des elements rappeles doit etre au moins egal au nombre des elements 
memorises. 

Si la regie 2 est suivie et si la regie 1 est suivie pour les dimensions qui sont communes aux 
deux tableaux (ce doit etre les premieres dimensions) alors on peut rappeler un tableau de plus 
de dimensions que le tableau qui etait memorise. On obtient un message d'erreur, mais 
I'execution du programme se poursuit. 

DIM B (5,5,5,5) 

RECALL B 
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va travailler mieux dans I'exemple ci-dessus (apres le message d'erreur et avec de nombreux 
zeros supplementaires dans le tableau B) mais 

DIM 8(5,5,3,5) 

RECALL B 

va remplir le tableau B avec des nombres brouilles (apres avoir donne le message d'erreur) et 

DIM B (5,5,1,1) 

RECALL B 
va amener le message 

? OUT OF MEMORY ERROR 
parce que les (6*6*2*2) elements du tableau B sont en nombre moindre que les 6*6*6 elements 
memorises dans le tableau A. 

On peut memoriser uniquement des tableaux de nombres reels et entiers. Les tableaux chaTnes 
doivent etre convertis en un tableau d'entiers a I'aide de la fonction ASC pour pouvoir etre 
memorises. 

Bien que STORE et RECALL se referent a leurs variables sans mention d'indice ou de 
dimension, on ne peut memoriser ou rappeler que les tableaux. Le programme 

100 A(3) = 45 

110 A=27 

120 STORE A 

memorise sur bande les elements du tableau A(0) a A(10) (par defaut le tableau est 
dimensionne a 1 1 elements), et non la variable A (qui est egale a 27 dans le programme). 

L'instruction STORE ne delivre pas de message ou autre signal; I'utilisateur doit avoir son 
lecteur/enregistreur de cassette en marche en mode enregistrement lorsque l'instruction est en 
cours d'execution. Un bip signale le debut de I'enregistrement et un autre le bip en signale la fin. 
Le programme 

300 DIM B (5,13) 

310B = 4 

320 RECALL B 

lit sur la bande les 84 (6* 14) elements de tableau 8(0,0) a B(5,13). La valeur de la variable B 
n'est pas modifiee. Ici non plus il n'y a pas de message; des bips signalent le debut et la fin de 
la lecture. 

Si soit STORE soit RECALL contiennent un nom de tableau qui n'a pas ete precedemment 
dimensionne ou utilise avec un indice, on obtient le message 

? OUT OF DATA ERROR 
En mode d'execution immediate, si soit STORE soit RECALL se referent a un nom de tableau 
defini dans une ligne de programme a execution differee, alors la ligne de programme a 
execution differee doit avoir ete executee avant STORE ou RECALL. 

STORE et RECALL ne peuvent etre interrompus que par RESET. 

Si les mots reserves STORE ou RECALL sont utilises comme premiers caracteres d'un nom de 
variable quelconque, les instructions peuvent etre executees avant qu'il apparaisse un message 

? SYNTAX ERROR 
L'instruction 

STOREHOUSE=5 
amene le message 

? OUT OF DATA ERROR 
a moins que I'on ait defini un tableau dont le nom commence par le caractere HO. Dans ce 
dernier cas APPLESOFT va essayer de memoriser le tableau: vous allez d'abord entendre un 
bip puis un second bip, finalement il va apparaTtre le message ? SYNTAX ERROR du fait que 
APPLESOFT s'efforce d'analyser le reste de l'instruction "=5". Pour arreter les bips et le 
message d'erreur, vous pouvez enfoncer la touche RESET 
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L'instruction 

RECALLOUS=234 
va amener le message 

? OUT OF DATA ERROR 
a moins que I'on ait defini un tableau dont le nom commence par les caracteres OU. Dans ce 
cas APPLESOFT va attendre indefiniment qu'un tableau provienne du lecteur de cassette. La 
seule fagon de reprendre le controle de I'ordinateur est d'enfoncer la touche RESET. 
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CHAPITRE 6 

Instructions d'entree/sorte 

Dans le chapitre 3 voir egalement LOAD et SAVE 
Dans le chapitre 5 voir J I ORE et RECALL 

58 INPUT 

59 GET 

60 DATA 

61 READ 

61 RESTORE 

62 PRINT 

62 IN# 

63 PR# 

63 LET 

64 DEF FN 
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INPUT dif 

INPUT dif 

INPUT [string;] var [{,var}] 

Si la chaine optionnelle est omise, INPUT imprime un point d'interrogation et attend que 
I'utilisateur tape un nombre (si var est une variable arithmetique) ou des caracteres (si var est 
une variable chaine). La valeur de ce nombre ou de cette chaine est placee dans var. 

S'il y a une chaine, elle est imprimee exactement comme specifie; aucun point d'interrogation 
espace blanc ou autre signe de ponctuation n'est imprime apres la chaine. Notez que I'on ne 
peut utiliser qu'une seule chaine optionnelle. Elle doit apparaitre directement apres INPUT et 
etre suivie d'un point virgule. 

INPUT va accepter uniquement un reel ou un entier comme entree numerique et non une 
expression arithmetique. Les caracteres espace blanc, +, -, E, et le point sont des parties 
legitimes de I'entree numerique. INPUT va accepter chacun de ces caracteres ou toute 
contenation de ces caracteres sous forme acceptable ( ar exemple +, -, E est acceptable, +, - 
ne Test pas); une telle entree par elle-meme s'evalue comme 

Dans une entree numerique les espaces blancs sont ignores en n'importe quelle position. Si 
I'entree numerique n'est pas un reel, un entier, une virgule ou un point et virgule, il apparait le 
message 

7REENTER et I'instruction INPUT doit etre re executee. 

Si on utilise une instruction ONERR, avec un autre GOTO dans la routine de traitement des 
erreurs pour renvoyer le programme a I'instruction INPUT defaillante, la 86e erreur INPUT peut 
faire que le programme saute au moniteur. Pour le reprendre, utilisez reset Ctrl C return. On 
peut eviter ce probleme en utilisant RESUME pour revenir a I'instruction 

De la meme fagon une reponse assignee a une variable chaine doit etre une chaine simple ou 
expression litterale et non une expression chaine. Les espacements blancs qui precedent le 
premier caractere sont ignores. Si la reponse est une chaine, des guillemets a un endroit 
quelconque dans la chaine vont amener un message 
7REENTER 

Toutefois, a I'interieur d'une chaine tous les caracteres, a I'exception des guillemets, de Ctrl X et 
de Ctrl M sont acceptes comme caracteres pour la chaine. Ceci comprend les deux points et la 
virgule. Les espaces blancs qui suivent le guillemet final sont ignores. 

Si la reponse est une expression litterale, alors les guillemets sont acceptes comme caracteres 
en toute partie de I'expression litterale sauf comme premier caractere qui ne soit pas un espace 
blanc. Les espaces qui suivent le dernier caractere sont acceptes comme partie de I'expression 
litterale. Toutefois la virgule et les deux points (et Ctrl X et Ctrl M) ne sont pas acceptes comme 
caracteres dans I'expression litterale. 

Si I'utilisateur enfonce simplement la touche RETURN alors que I'on attend une reponse 
numerique, il ressort le message 
7REENTER 

et I'instruction INPUT est re executee. Si I'on enfonce seulement la touche RETURN lorsqu'on 
attend une reponse chaine, cette reponse est interpret.ee comme chaine nulle et I'execution des 
programmes continue. 

Les variables successives sont affectees des valeurs successivement tapees. Les variables 
chaines et les variables arithmetiques peuvent etre melangees dans la meme instruction 
INPUT, mais les reponses de I'utilisateur doivent etre chacune du type approprie. Les reponses 
tapees peuvent etre separees par des virgules ou des return. II en resulte que si un utilisateur 
tape des virgules dans une reponse qui ne commence pas par des guillemets, tous les 
caracteres tapes a la suite sont ignores. Apres un deux points, les virgules sont egalement 
ignorees, de sorte que le debut d'une autre reponse doit etre signale par un return. 
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Si un return est rencontre avant affectation de response a toutes variables, deux points 
d'interrogation sont imprimes pour indiquer que I'on attend une reponse supplemental. 
Lorsque I'on rencontre un return, si la reponse contient davantage de champs de reponse que 
I'instruction ne I'attendait, ou s'il existe un deux points dans la reponse finale attendue (mais non 
a I'interieur d'une chaine), alors on regoit le message 

? EXTRA IGNORED 
et I'execution du programme continue. 

Si un deux points ou une virgule est le premier caractere d'une reponse INPUT, la reponse est 
evaluee pour zero ou comme chaine nulle. 

Notez que dans I'instruction INPUT la chaine optionnelle doit etre suivie par un point virgule 
mais que les variables doivent etre separees par des virgules. 

Ctrl C peut interrompre une instruction INPUT mais uniquement si c'est le premier caractere 
tape. Le programme s'arrete lorsque I'on tape return. Un essai de continuer I'execution apres un 
tel arret se traduit par le message d'erreur 

? SYNTAX ERROR Ctrl C est traite comme tout autre caractere si ce n'est pas le 
premier caractere tape. 

En essayant d'utiliser I'instruction INPUT en mode execution directe on obtient le message 
? ILLEGAL DIRECT ERROR 

GET 

GET dif seulement 
GET var 

Met en place un unique caractere a partir du clavier, sans I'afficher sur I'ecran et sans 

necessiter d'enfoncer la touche RETURN. 

Le comportement de GET svar reserve parfois des surprises 

Ctrl C @ amene le caractere nul. 

Le resultat de la mise en place d'une fleche gauche ou de Ctrl H peut egalement I'imprimer, 
comme si le caractere nul etait obtenu. 

Ctrl C est traite comme tout autre caractere; il n'interrompt pas I'execution du programme. 

Bien que APPLESOFT n'ai pas ete etudie ou prevu pour prendre (instruction GET) des valeurs 
arithmetiques, vous pouvez utiliser 
GET avar 

sous reserve des strides limitations suivantes: 

m 

L'entree (instruction GET) d'un deux point ou une virgule se traduit par le message 
? EXTRA IGNORED 

suivi de I'obtention d'un zero comme valeur tapee. 

Le signe plus, le signe moins, ctrl@,E, un espace blanc et le point donnent tous un zero comme 
valeur tapee. 

En tapant un return ou une entree non numerique on obtient le message 
? SYNTAX ERROR 

Avec ONERR GOTO . . . RESUME deux erreurs consecutives GET obligent le systeme a 
s'arreter jusqu'a ce que I'on enfonce RESET. Si I'on remplace RESUME par GOT, tout est bien 
jusqu'a la 43e erreur GET (dans un ordre quelconque), ou le programme saute au moniteur. 
Pour le recuperer, utilisez reset Ctrl C return. 
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Du fait de ces limitations il est recommande aux programmeurs serieux de mettre en place des 
nombres en utilisant 
GET svar 

et en convertissant la chaTne resultante en un nombre a I'aide de la fonction VAL. 

DATA 

DATA dif 

DATA [litterale I chaTne I reel I entier] f (, [litterale I chaTne I reel I entier] } ] 

Cette instruction cree une liste d'elements que I'on peut utiliser au moyen des instructions 
READ. Dans I'ordre du numero de ligne de I'instruction, chaque instruction DATA ajoute ses 
elements a la liste des elements obtenus par les precedentes instructions DATA du programme 
(numero de ligne inferieur). 

II n'est pas necessaire que I'instruction DATA precede I'instruction READ dans un programme; 
les instructions DATA peuvent apparaTtre a tout endroit d'un programme. 

Les elements DATA qui sont affectes aux variables arithmetiques par I'instruction READ suivent 
generalement les memes regies que pour les reponses assignees par I'instruction INPUT aux 
variables arithmetiques par I'instruction READ suivent generalement les memes regies que pour 
les reponses assignees par I'instruction INPUT aux variables arithmetiques. Toutefois, le deux 
points ne peut pas etre inclus comme caractere dans un element numerique DATA. 

Si Ctrl C est un element DATA, il n'arrete pas le programme meme s'il est le premier caractere 
d'un element. Sous reserve de cette exception, les elements DATA qui sont affectes aux 
variables chaTnes par I'instruction READ suivent les memes regies que les reponses affectees 
par I'instruction INPUT aux variables chaTnes: 

On peut utiliser soit des chaTnes soit des expressions litterales, soit les deux. 

Les espaces blancs avant le premier caractere et suivant une chaTne sont toujours ignores. 

Tout guillemet qui apparaTt a I'interieur d'une chaTne amene le message 7SYNTAX ERROR, 
mais tous les autres caracteres sont acceptes comme caracteres dans cette chaTne y compris le 
deux points et la virgule (mais non compris Ctrl X et Ctrl M1 . 

Si un element est une expression litterale, alors le guillemet est accepte comme caractere 
valide a tout endroit de I'expression litterale sauf comme premier caractere qui ne soit pas un 
espace blanc; le deux points, la virgule, Ctrl X et Ctrl M ne sont pas acceptes. 

Voir I'instruction INPUT pour autres details. 

Les elements DATA peuvent etre tout melange de reels, entiers, chaTnes et expressions 
litterales. Si I'instruction READ essaie d'assigner un element DATA c'est-a-dire une chaTne ou 
une expression litterale a une variable arithmetique, on obtient le message 7SYNTAX ERROR 
pour la ligne DATA appropriee. 

Si la liste d'elements d'une instruction DATA contient un element "non existant", alors on obtient 
un zero (numerique) ou la chaTne nulle pour cet element selon la variable a laquelle on a 
assigne I'element. Un element "non existant" se presente dans une instruction DATA si I'une 
des conditions suivantes est vraie. 

1) II n'y a pas de caracteres autres que des espaces blancs entre DATA et return 

2) Une virgule est le premier caractere autre qu'un espace blanc a la suite de DATA 

3) Entre deux virgules, il n'y a pas de caracteres qui ne soient pas un espace blanc 

4) La virgule est le premier caractere qui ne soit pas un espace blanc avant return 
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Par consequent lorsque cette instruction est lue 
100 DATA, , 

elle peut donner jusqu'a trois elements consistant en zeros ou en chaines nulles. 

Si on I'utilise en mode execution immediate, DATA n'amene pas de message SYNTAX ERROR 
mais ses elements ne sont pas disponibles pour une instruction READ 

READ 

READ imm & dif 
READ var [{,var}] 

Lorsque la premiere instruction READ est executee dans un programme, sa premiere variable 
prend la valeur du premier element de la liste DATA (la liste DATA comprend tous les elements 
de toutes les instructions DATA du programme memorise). La seconde variable (s'il y en a une 
seconde) prend la valeur du second element qui se trouve dans la liste DATA et ainsi de suite. 
Lorsque I'instruction READ acheve son execution, elle laisse un pointeur de listes de donnees 
(DATA) apres le dernier element de donnees utilise. L'instruction READ suivante executee (s'il y 
a lieu) commence en utilisant la liste de donnees a partir de la position du pointeur. Les 
instructions RUN ou RESTORE ramenent le pointeur au premier element de la liste DATA. 

Un essai de lire (instruction READ) plus de donnees que la liste de donnees n'en contient donne 
le message 

? OUT OF DATA ERROR IN linenum 
ou linenum est le numero de la ligne d'instruction READ qui demande des donnees 
supplementaires. 

En mode immediat, vous pouvez seulement lire (instruction ) des elements a partir des 
instructions DATA qui existent comme lignes dans un programme actuellement memorise. Les 
elements de DATA dans un programme memorise peuvent etre lus meme si le programme 
memorise n'est pas passe. Si aucune instruction DATA n'a ete memorisee, on obtient le 
message 

? OUT OF DATA ERROR IN linenum 
L'execution du programme en mode immediat ne ramene pas le pointeur de la liste de donnees 
au premier element de la liste DATA. 

Les donnees supplementaires non lues demeurent inchangees. 

RESTORE 

RESTORE imm & dif 

RESTORE n'a pas de parametre ni d'option. Cette instruction deplace simplement le pointeur 
de liste de donnees (voir instructions READ et DATA) pour le ramener au debut de la liste de 
donnees. 

PRINT 

PRINT imm & dif 

PRINT [{expr} fil; [f expr}]}]] (,!;] 

PRINT {;} 

PRINT f , I 

Le point d'interrogation (?) peut s'utiliser comme abreviation pour PRINT; il s'affiche comme 
Sans option, PRINT se traduit par I'impression d'une ligne et un retour du chariot sur I'ecran. 
Lorsque des options sont exercees, ce sont les valeurs de la liste des expressions specifiees 
qui sont imprimees. Si ni une virgule, ni un point et virgule ne termine la liste, une impression de 
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ligne, un retour de chariot sont executes a la suite du dernier item imprime. Si un item de la liste 
est suivi par une virgule, alors le premier caractere du item suivant a imprimer va apparaTtre a la 
premiere position du champ de tabulateur suivant disponible. 

Le premier champ de tabulateur comprend les 16 positions d'impression les plus a gauche de la 
fenetre du texte, positions 1 a 16. Le second champ du tabulateur occupe les 16 positions 
suivantes (1 7 a 32) et n'est disponible pour impression en champ de tabulateur que sil n'y a rien 
imprime en position 16. Le troisieme champ du tabulateur comprend les huit positions 
d'impression restantes (33 a 40) et n'est disponible que si rien n'est imprime sur les positions 24 
a 32. 

On peut modifier la taille de la fenetre de defilement du texte a I'aide des differentes instructions 
POKE (voir appendice J). 

# 

Le champ d'impression avec tabulateur 3 ne fonctionne pas correctement si la fenetre de texte 
est definie a une largeur inferieure a 33 positions; le premier caractere peut etre imprime a 
I'exterieur de la fenetre du texte. 

HTAB peut egalement faire que PRINT affiche un premier caractere a I'exterieur de la fenetre 
de texte. 

Si un item de la liste est suivi par un point et virgule, alors I'item suivant est concatene: il est 
imprime directement a la suite sans espace blanc intermediaire. 

Les items listes sans virgules ou points et virgules intermediaires sont concatenes si les items 
peuvent etre analyses sans presenter de problemes de syntaxe. Ceci est mieux illustre par des 
exemples 

A=1 : B=2 : C=3 : C141=5: C5=7 

PRINT 1/3(2'4)51 , : PRINT 1 1 A)2(B)3C(4)C5 

.333333333851 1122357 

PRINT 3.4.5.6. , : PRINT A."B."C4 

3.4.5.60 1 0B. 3.4 

PRINT s'efforce de faire apparaTtre ce que vous souhaitez. S'il ne peut pas interpreter un point 
comme 

point decimal, il le traite comme le nombre zero, comme illustre sur les exemples ci-dessus. 
PRINT suivi d'une liste de points et virgules ne fait rien de plus que PRINT seul, mais est legal. 
PRINT suivi d'une liste de virgules defini un champ de tabulateur pour chaque virgule, ceci dans 
une limite de 239 caracteres par instruction. 

PRINT A$+ B$ 
donne le message 

? STRING TOO LONG ERROR 
Si la longueur des chaines concatenees est superieure a 255. Toutefois vous pouvez imprimer 
la concatenation apparente en utilisant 

PRINT A$ B$ 
sans vous inquieter de sa longueur. 

IN# 

IN# imm & dif 
IN# aexpr 

selectionne une entree en provenance du slot \aexpr\. Utilisee pour specifier quel peripherique 
fournira une entree pour les instructions INPUT suivantes. Les peripheriques peuvent etre dans 
les slots 1 a 7, comme indique par \aexpr\. 
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IN# indique que I'entree suivante proviendra du clavier au lieu de provenir du peripherique. Le 
slotO 

n'est pas adressable au moyen de APPLESOFT pour utilisation avec un appareil peripherique. 

S'il n'y a pas de peripherique dans le slot \ aexpr \, le systeme va s'arreter. Pour le recuperer, 
utilisez reset Ctrl C return. 

Si \ aexpr \ est inferieur a ou superieur a 255 on obtient le message 
? ILLEGAL QUANTITY ERROR 



Si \ aexpr \ est dans I'etendue 8 a 255, APPLESOFT est modifie de fagon imprevisible. 
Pour des transferts similaires de resultats de sortie, voir PR#. 

PR# 

PR# imm & dif 
PR# aexpr 

PR# transfere les resultats de sortie au slot \aexpr\, ou \aexpr\ doit etre dans I'etendue 1 a 7 
inclusivement. 

PR# envoie les resultats de sortie sur I'ecran TV et non au siot 

S'il n'y a pas de peripherique dans le slot specifie, le systeme va s'arreter. Pour le recuperer, 
utilisez Ctrl C return 

Si \aexpr\ est inferieur a 255, on obtient le message 
? ILLEGAL QUANTITY ERROR 




Si \aexpr \ est dans I'etendue 8 a 255, APPLESOFT est modifie de fagon imprevisible pour des 
transferts similaires, de donnees d'entrees voir IN# 

LET 

LET imm & dif 

[LET] avar[indice] = aexpr 

[LET] svarfindice] = sexpr 

La variable dont le nom est a gauche regoit la valeur de la chaine ou de I'expression qui est a 
droite. Le LET est optionnel 
A=2 

et 

A=2 
sont equivalents 

Le message 

? TYPE MISMATCH ERROR 
est affiche si vous essayez de donner 

a) un nom de variable chaTne a une expression arithmetique ou 

b) un nom de variable chaTne a une expression litterale ou 

c) un nom de variable arithmetique a une expression chaTne 

Si vous essayez de donner un nom de variable arithmetique a une expression litterale: 
APPLESOFT essaie d'analyser une expression litterale comme expression arithmetique. 
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DEF 



DEF dif 

FN imm & dif 

DEF FN name (real avar) = aexprl 
FN name (aexpr2) 

permet a I'utilisateur de definir des fonctions dans un programme. D'abord la fonction FN name 
est definie a I'aide de DEF. Lorsque la ligne de programme definissant la fonction a ete 
executee, la fonction peut etre utilisee dans la forme FN name argument) ou I'argument aexpr2 
peut etre toute expression arithmetique. L'expression aexprl de definition ne peut avoir qu'une 
seule ligne de programme de longueur; la fonction FN name ainsi definie peut etre utilisee 
partout ou des fonctions arithmetiques peuvent etre utilisees dans APPLESOFT. 

De telles fonctions peuvent etre redefinies pendant le cours d'un programme. Les regies 
d'utilisation des variables arithmetiques s'appliquent encore. En particulier les deux premiers 
caracteres du nom doivent etre uniques. Lorsque ces lignes 

10 DEF FN ABC(l)=COS(l) 

20 DEF FN ABT(I)=TAN(I) 
sont executees, APPLESOFT reconnaTt la definition d'une fonction FN AB a la ligne 10; a la 
ligne 20, la fonction FN AB est redefinie. 

Dans I'instruction DEF, real avar est une variable factice. Lorsque la fonction FN name, definie 
par I'utilisateur, est utilisee ensuite, elle est appelee avec un argument aexpr2. Cet argument 
remplace real avar partout ou il apparaTt dans l'expression de definition aexprl. aexprl peut 
contenir tout nombre de variables, mais bien entendu une d'entre elles seulement correspond a 
la variable factice real avar et done correspond a la variable argument. 

II n'est pas necessaire que real avar de la definition apparaisse dans aexprl. Dans ce cas 
lorsqu'on utilise la fonction plus loin dans le programme, I'argument de la fonction est ignore 
dans revaluation de aexprl. Meme dans ce cas toutefois, I'argument de la fonction est evalue 
lui-meme et il doit done etre quelque chose de legal. 

Par exemple 

100 DEF FN A(W) = 2*W + W 
110 PRINT FN A(23) 
120 DEF FN B(X) = 4 + 3 
130G = FN B(23) 
140 PRINT G 

150 DEF FN A(Y) = FN B(Z) + Y 
160 PRINT FN A(G) 

RUN 

69 [ FN A(23)=2*23+23] 

7 [ FN B(quelque chose)=7] 

14 [ new FN A(7)=7+7] 

Si une instruction DEF FN name a execution differee n'est pas executee avant d'utiliser FN 
name, on obtient le message 

? UNDEF'D FUNCTION ERROR 

Les fonctions chaTnes definies par I'utilisateur ne sont pas autorisees. Les fonctions definies a 
I'aide d'un integer name% (nom de variable entiere) pour name ou pour real avar ne sont pas 
autorisees. 

Lorsqu'une nouvelle fonction est definie par une instruction DEF, 6 octets en memoire sont 
utilises pour memoriser le pointeur relatif a cette definition. 
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CHAPITRE 7 

Instructions relatives au deroulement du programme 



76 GOTO 

76 IF . . . THEN et. IF . . . GOTO 

78 FOR . . . TO . . . STEP 

79 NEXT 

79 GOSUB 

80 RETURN 

80 POP 

81 ON . . . GOTO et ON . . . GOSUB 

81 ONERR GOTO 

82 RESUME 
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GOTO 



GOTO Imm & dif 
GOTO linenum 

effectue le branchement a la ligne dont le numero de ligne est linenum. Si cette ligne n'existe 
pas ou s'il n'y a pas linenum dans I'instruction GOTO, on a le message d'erreur 

?UN DEF'D STATEMENT ERROR IN linenum 
ou linenum est le numero de la ligne de programme qui contient I'instruction GOTO 

// 

IF imm & dif 

IF exprTHEN instruction [(: instruction}] 
IF exprTHEN [GOTO] linenum 
IF expr [THEN] GOTO linenum 

Si expr est une expression arithmetique dont la valeur n'est pas zero let dont la valeur absolue 
est superieure a environ 2.93873E-391 , expr est considere etre vrai et toutes les instructions qui 
suivent THEN sont executees. 

Si expr est une expression arithmetique dont la valeur est zero (ou dont la valeur absolue est 
inferieure a environ 2.93873E-391, toutes les instructions qui suivent THEN sont ignorees et 
I'execution passe a I'instruction de la ligne de programme numerotee a la suite. 

Lorsque I'instruction IF se presente dans un programme a execution immediate, si \expr \ est 
zero, APPLESOFT va ignorer la totalite du reste du programme. 

Si expr est une expression arithmetique impliquant des expressions chaTnes et des operateurs 
logiques chaTnes, expr est evalue par comparaison du rangement alphabetique des expressions 
chaTnes comme determine par les codes ASCII pour les caracteres impliques (voir appendice 
K). 

Les instructions de la forme 
IF expr THEN 

sont valides: on n'obtient pas de message d'erreur. Un THEN sans un IF correspondant ou un 
IF sans un THEN amene le message. 
? SYNTAX ERROR 

APPLESOFT n'a pas ete etudie ou prevu pour permettre a I'expression de I'instruction IF d'etre 
une expression chame, mais les variables chaTnes et les chaTnes peuvent s'utiliser pour expr 
sous les strides conditions suivantes: 

Si expr est une expression chaTne d'un type quelconque alors \expr \ est non-zero, meme si 
expr est une variable chaTne a laquelle on a assigne aucune valeur ou une valeur zero ou la 
chaTne nulle, "" Toutefois, la chaTne nulle litterale comme dans 

IF""THEN . . . 
est evaluee a zero. 

IF chaTne THEN, si on I'execute plus de deux ou trois fois dans un programme donne, amene le 
message 

? FORMULA TOO COMPLEX ERROR 
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si expr est une variable chaine et si I'instruction precedente a assigne la chaine nulle a toutes 
les variables chaTnes, alors expr est evalue pour zero. Par exemple le programme: 

120 IFA$ THEN PRINT "A$" 

130 IF B$ THEN PRINT "B$" 

140 IF X$ THEN PRINT "X$" 
lorsqu'on le fait passer, imprime 

A$ 

B$ 

X$ 

parce que les chaTnes AS, BS et XS sont evaluees comme non-zero. Toutefois le fait d'ajouter 
la ligne 

100 QS = "" 

fait que les trois chaTnes sont evaluees pour zero et qu'il n'y a pas de sortie imprimee. Le fait 
d'effacer la ligne 1 00 ou d'ajouter une ligne 1 1 du genre de 
110 F=3 

fait a nouveau que les trois chaTnes sont evaluees comme non-zero. 




Avant THEN, la lettre A cause des problemes d'analyse 

IF BETA THEN 230 
s'analyse comme 

IF BET AT HEN230 
qui amene un message d'erreur 

? SYNTAX ERROR 
a I'execution. 

Les instructions suivantes sont equivalentes: 
IFA=3 THEN 160 
IF A=3 GOTO 160 
IFA=3 THEN GOTO 160 

FOR 

For imm & dif 

FOR real avar = aexprl TO aexpr2 [STEP aexpr3] 

\avar\ est positionne a \aexprl \ et les instructions qui suivent le FOR sont executees jusqu'a ce 
que Ton rencontre une instruction NEXT avar ou avar est le meme nom que celui qui apparaTt 
dans I'instruction FOR. 

Puis \ avar \ est increments de la valeur de \ aexpr3 \ (la valeur par defaut de \ aexpr3 \ est 1 1 . 
Puis \ avar \ est compare a aexpr2 et si \ avar \ > \aexpr2, \ I'execution se poursuit avec 
I'instruction qui suit le NEXT. Par contre si \avar \ <= \aexpr2, \ I'execution se poursuit selon 
I'instruction qui suit le FOR. 

Si \aexpr3,\ alors I'operation est legerement differente apres que Ton a ajoute \aexpr3\ a \ avar. \ 
Si avar < \aexp2, \ I'execution se poursuit avec I'instruction qui suit le NEXT. Si \avar \ > = 
\aexpr2, \ I'execution se poursuit selon I'instruction qui suit le FOR. 

Les expressions arithmetiques qui torment les parametres de la boucle FOR peuvent etre des 
nombres reels, des variables reelles, des entiers ou des variables entieres. Toutefois, real avar 
doit etre une variable reelle. Un essai d'utiliser une variable entiere pour avar amene le 
message 

? SYNTAX ERROR 
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Du fait que \ avar \ n'est increments et compare a \ aexpr \ qu'a la fin de la boucle FOR . . . 
NEXT, la partie du programme qui se trouve a I'interieur de la boucle est done toujours executee 
au moins une fois. Les boucles FOR . . . NEXT ne doivent pas se chevaucher I'une I'autre. Dans 
ce cas on aurait le message 

? NEXT WITHOUT FOR ERROR 

Si des boucles FOR sont emboTtees I'une dans I'autre avec plus de 10 niveaux de profondeur, 
on obtient le message 

? OUT OF MEMORY ERROR 

Pour executer une boucle FOR . . . NEXT en mode execution immediate, I'instruction FOR et 
I'instruction NEXT doivent etre toutes les deux sur la meme ligne lune ligne peut avoir jusque 
239 caracteres de long). 



Si la lettre A est utilisee immediatement avant TO, ne laissez pas d'espace entre T et 0. FOR 
l=BETA TO 56 est bon, mais FOR l=BETA TO 56 s'analyse comme FOR l=BET ATO 56 et 
donne le message ' 

? SYNTAX ERROR 

chaque boucle active FOR. . . NEXT utilise 16 octets en memoire. 

NEXT 

NEXT imm & dif 
NEXT [avar] 
NEXT avar [{ avar} ] 

Constitue la fin d'une boucle FOR . . . NEXT. Lorsque Ton rencontre un NEXT le programme soit 
I'ignore, soit se branche sur I'instruction qui suit le FOR correspondant, selon les conditions que 
Ton a expliquees dans la discussion concernant I'instruction FOR. 

Des avars multiples doivent etre specifies dans I'ordre correct de facon que les boucles FOR . . . 
NEXT soient emboTtees I'une dans I'autre et ne se chevauchent pas. Des avars dans un ordre 
incorrect donnent le message 

? NEXT WITHOUT FOR ERROR. 

Une instruction NEXT dans laquelle on ne specifie pas de nom de variable se refere par defaut 
a la boucle FOR la plus recemment entree qui soit encore en effet. S'il n'y a pas d'instruction 
FOR du meme nom de variable qui soit encore en effet ou s'il n'y a pas d'instruction FOR, d'un 
nom quelconque, en effet, lorsque Ton rencontre un NEXT sans nom, on obtient le message 
? NEXT WITHOUT FOR ERROR. 

NEXT sans avar s'execute plus rapidement que ne le fait NEXT avar. 

En mode d'execution immediate, I'instruction FOR et son instruction correspondante NEXT 
doivent etre executees toutes les deux sur la meme ligne. 

Si une instruction FOR a execution differee est encore en effet, une instruction NEXT a 
execution immediate peut causer un saut au programme a execution differee s'il y a lieu. 
Toutefois, I'instruction FOR a ete executee en execution immediate, une instruction NEXT qui 
se trouve sur une ligne differente a execution immediate va amener le message 
? SYNTAX ERROR 
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a moins qu'il n'y ait pas de lignes intermediates et que NEXT soit seul et sans nom. 
]FOR I = 1 a 5 : PRINT I 
1 

]NEXT 
2 

]NEXT 
3 

]NEXT I 

7SYNTAX ERROR IN xxxx (XXXX est un numero de ligne quelconque.) 

GOSUB 

GOSUB imm & dif 
GOSUB linenum 

Le programme se branche a la ligne indiquee. Lorsqu'on rencontre I'instruction RETURN, le 
programme se branche sur I'instruction qui suit immediatement I'instruction GOSUB executee 
en dernier lieu. 

Chaque fois que Ton execute une instruction GOSUB, I'adresse de I'instruction suivante est 
memorisee en tete d'une pile de ces adresses, pour que le programme puisse ensuite retrouver 
son chemin. Chaque fois que Ton execute une instruction RETURN ou POP, I'adresse de tete 
de la pile RETURN est enlevee. 

Si le linenum indique ne correspond pas a une ligne de programme existante, on obtient le 
message d'erreur ?UNDEF'D STATEMENT ERROR IN linenum, ou linenum indique la ligne de 
programme qui contient I'instruction. La portion du message 
IN linenum 

est omise si GOSUB est utilise en mode execution directe. 

Si les GOSUB sont emboTtes a plus de 25 niveaux de profondeur, on obtient le message 
?OUT OF MEMORY ERROR 

Chaque instruction active GOSUB (c'est-a-dire qui n'a pas encore ete suivie d'une instruction 
RETURN) utilise 6 octets de memoire. 

RETURN 

RETURN Imm & dif 
II n'y a pas de parametre ni d'options dans cette instruction. 

C'est un branchement a I'instruction qui suit immediatement le GOSUB execute en dernier lieu. 
L'adresse de I'instruction a laquelle on se branche est celle qui se trouve en tete de la pile 
RETURN (voir GOSUB et POP). 

Si un programme rencontre des instructions RETURN une fois de plus qu'il n'a rencontre des 
instructions GOSUB, on obtient le message 

7RETURN WITHOUT GOSUB ERROR. 
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POP 



POP imm & dif 

II n'y a pas de parametre ni d'options associes a POP. Un POP a I' effet d'un RETURN sans le 
branchement. Le prochain RETURN que Ton rencontrera, au lieu d'effectuer un branchement a 
une instruction qui se trouve au-dela du GOSUB rencontre en dernier lieu, effectuera un 
branchement sur une instruction qui se trouve au-dela du second GOSUB execute en dernier 
lieu. On I'appelle un POP car il fait sauter (POP) une adresse de la tete de la pile d'adresses 
RETURN. 

Si I'instruction POP est executee avant que Ton ne rencontre un GOSUB, on obtient le 
message? 

RETURN WITHOUT GOSUB ERROR. 

ON... GOTO 

ON . . . GOSUB dif 

car il n'y a pas d'adresse de retour sur la pile. ON aexpr GOTO linenum 1 [ linenuml i ON aexpr 
GOSUB linenum (f, linenuml ) 

ON . . . GOTO effectue un branchement sur la ligne, dont le numero est specifie pas I'item \ 
aexpr \, de la liste des linenums apres le GOTO. ON . . . GOSUB travaille de facon semblable, 
mais on execute alors un GOSUB plutot qu'un GOTO. 

Si aexpr est zero ou superieur au nombre de linenums possibles de la liste, mais inferieur a 
256, alors I'execution du programme se poursuit jusqu'a I'instruction suivante: 
aexpr doit etre sur I'etendue a 255 pour eviter le message 
7ILLEGAL QUANTITY ERROR 

ONERR GOTO 

ONERR GOTO linenum 

Si une erreur se produit on peut utiliser ONERR GOTO pour eviter d'avoir un message d'erreur 
et un arret de I'execution. Cette instruction positionne un indicateur qui cause un saut 
inconditionnel (si une erreur se produit ensuite sur le programme) sur la ligne de programme 
indiquee par linenum. POKE 216,0 ramene a I'origine I'indicateur de detection d'erreur de sorte 
que les messages d'erreur apparaitront normalement. 

L'instruction ONERR GOTO doit etre executee avant I'apparition d'une erreur pour eviter 
I'interruption du programme. 

Si une erreur se produit dans le programme, le code du type d'erreur est memorise a 
I'emplacement decimal 222 de la memoire. Pour voir quelle erreur on a rencontree, utilisez 
I'instruction PRINT PEEK (222). 



Code 


Message d'erreur 


Code 


Message d'erreur 





NEXT sans FOR 


120 


tableau redimensionne 


16 


Syntaxe 


133 


division par zero 


22 


RETURN sans GOSUB 


163 


pas de concordance de frappe 


42 


En dehors des donnees 


176 


ChaTne trap longue 


53 


Quantite illegale 


191 


Formule trap complexe 


69 


Depassement 


224 


fonction non definie 


77 


en dehors de la memoire 


254 


mauvaise reponse a I'instruction INPUT 


90 


instruction non definie 


255 


essai d'interruption par Ctrl C 


107 


indice errone 
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II faut faire attention pour le traitement des erreurs qui se produisent a I'interieur des boucles 
FOR . . . NEXT ou entre GOSUB et RETURN POP, car les pointeurs et les piles RETURN POP 
sont perturbes. La routine de traitement des erreurs doit recommencer la boucle, en repartant a 
I'instruction FOR ou GOSUB et non a I'instruction NEXT ou RETURN POP. Apres le traitement 
de I'erreur, en arrivant a un NEXT ou a un RETURN POP, on aura le message approprie 

?NEXT WITHOUT FOR ERROR ON 7RETURN WITHOUT GOSUB ERROR 




Si on utilise ONNER GOTO avec RESUME pour traiter les erreurs dans une instruction GET, le 
programme sera suspendu s'il y a deux erreurs GET consecutives sans un GET reussi 
intermediaire. Pour echapper a la suspension de programme, utilisez reset Ctrl C return. Si 
GOTO termine la routine de traitement de I'erreur, tout marche bien (mais voir note suivante). 

Lorsqu'on I'utilise en mode TRACE ou dans un programme contenant une instruction PRINT, 
ONERR cause un saut au moniteur lorsque Ton a rencontre 43 erreurs. La ou ces erreurs sont 
generees par une instruction INPUT, tout marche bien si on utilise RESUME; mais si GOTO 
termine la routine de traitement d'erreur, la 87e erreur INPUT cause un saut au moniteur. A 
nouveau reset Ctrl C return vous ramenera a APPLESOFT. 

Si vous etes gene par I'un des problemes dont nous venons de discuter, executez un CALL 
pour appeler le sous-programme suivant de langage assembleur faisant partie de votre routine 
de traitement d'erreur. 

Dans le moniteur entrez les donnees en hexadecimal: 68 A8 68 A6 DIF 9A 48 60 ou en 
APPLESOFT, entrez les donnees en decimal: 104 168 104 166 223 154 72 152. 

Par exemple en APPLESOFT vous pourriez ecrire (instruction POKE) les nombres decimaux 
aux emplacements 768. 777. 

Puis vous utiliseriez CALL 78 dans votre routine de traitement d'erreur. 

RESUME 

RESUME dif 

Lorsqu'on I'utilise a la fin d'une routine de traitement d'erreur, cette instruction fait que le 
programme reprend I'execution au debut de I'instruction ou une erreur s'est produite. 

Si RESUME se rencontre avant qu'une erreur ne se produise, le message 

7SYNTAX ERROR IN 65278 

peut arriver ou tout autre evenement etrange. Habituellement votre programme sera arrete ou il 
sera suspendu. 

Si une erreur se produit dans une routine de traitement d'erreur, I'emploi de RESUME va placer 
le programme dans une boucle sans fin. Pour en echapper utilisez reset Ctrl C return. 
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En mode d'execution immediate, cette instruction peut mettre le systeme en suspension, peut 
amener une erreur de syntaxe ou peut commencer I'execution d'un programme existant ou 
meme d'un programme efface. 
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CHAPITRE 8 

Commandes graphiques et commandes de jeux 



84 TEXT 

Graphiques basse resolution 

84 GR 

85 COLOR 

85 PLOT 

86 HLIN 

86 VLIN 

87 SCRN 

Graphiques haute resolution 

87 HGR 

88 HGR2 

89 HCOLOR 

89 HPLOT 

Game Controls 

90 PDL 
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TEXT 



TEXT imm & dif 
TEXT imm & dif 

Pas de parametres. Positionne I'ecran en mode texte habituel, sur toute la largeur de I'ecran (40 
caracteres par ligne, 24 lignes) a partir du mode graphique basse resolution ou de I'un des deux 
modes graphiques haute resolution. Le caractere U) et le curseur sont amenes a la derniere 
ligne de I'ecran. En edition en mode texte, TEXT est equivalent a VTAB 24. 
Une instruction comme 

175 TEXTILE = 127 

amene I'execution du mot reserve avant I'apparition du message d'erreur 7SYNTAX ERROR. Si 
la fenetre de texte a ete positionnee a une largeur autre que la pleine largeur (voir appendix J), 
TEXT la ramene a la pleine largeur de I'ecran. 

GR 

GR imm & dif 
GR 

Pas de parametres. Cette instruction positionne le mode graphique basse resolution (40 par 401 
pour I'ecran, en laissant quatre lignes pour le texte en bas de I'ecran. L'ecran est efface pour 
devenir noir et le curseur est deplace dans la fenetre de texte. Peut etre converti en graphique 
pleine largeur (40 par 48) apres execution de GR avec I'instruction 

POKE - 16302,0 
ou I'instruction equivalente 

POKE 49234,0 

Si GR suit une instruction POKE pour la totalite de I'ecran, c'est le mode mixte graphique plus 
texte qui est obtenu. 

Apres une commande GR, la couleur (instruction COLOR) est positionnee a zero. 




Si le mot reserve GR est utilise comme premiers caracteres d'un nom de variable, I'instruction 
GR peut etre executee avant de recevoir le message d'erreur 

7SYNTAX ERROR 
par exemple I'execution de I'instruction 

GRIN = 5 

vous laisse avec un ecran noir inattendu. 

m 

Si elle est executee pendant que HGR est en effet, I'instruction GR se comporte normalement. 
Au contraire si elle est executee pendant que c'est HGR2 qui est en effet, GR efface le contenu 
de I'ecran habituellement en memoire mais vous laisse regarder a la page 2 du graphique basse 
resolution et du texte. Pour revenir en mode normal, il suffit de taper TEXT. Dans les 
programmes, utiliser TEXT avant de commuter de HGR2 a GR. 
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COLOR 



COLOR imm & dif 
COLOR = aexpr. 

Definit la couleur pour le trace en mode graphique basse resolution. Si /aexpr/ est un nombre 
reel, il est converti en un entier. L'etendue des valeurs /aexpr/ va de o a 255; elles sont traitees 
modulo 16. 



Les noms des couleurs et leurs nombres associes sont: 



noir 

1 magenta 

2 blue fonce 

3 pourpre 



4 vert fonce 

5 gris 

6 blue moyen 

7 blue clair 



8 brun 

9 orange 

10 gris 

11 rose 



1 2 vert 

13 jaune 

14 aqua/turquoise claire 

15 blanc 



COLOR est positionne a zero par I'instruction GR. 



Pour connaTtre la couleur d'un point donne de I'ecran, utiliser I'instruction SCRN. 

Lorsqu'elle est utilisee en mode TEXT, COLOR est un facteur pour determiner quel caractere 
est place sur I'ecran par une instruction PLOT. Lorsqu'elle est utilisee en mode graphique haute 
resolution, I'instruction COLOR est ignoree. 



PLOT 

PLOT imm & dif 
PLOT aexprl. aexpr2 



En mode graphique basse resolution, cette instruction place un point de coordonnee X\ aexpr 1 
\ et de coordonnee y \ aexpr2 \ . La couleur de ce point est determinee par I'instruction executee 
la plus recente (COLOR=0 s'il n'y a pas de specification precedente). 

\aexprl \ doit etre sur l'etendue a 39 et \aexpr2 \ doit etre sur l'etendue a 47 sinon on regoit le 
message 

7ILLEGAL QUANTITY ERROR 



Une tentative d'utiliser I'instruction PLOT (trace) pendant que le systeme est en mode TEXT ou 
en mode mixte graphique plus texte avec \aexpr \ sur l'etendue 40 a 47 se traduit par le fait 
qu'un caractere est place a I'endroit ou le point de couleur etait apparu (un caractere occupe 
I'emplacement de deux points graphiques basse resolution empiles verticalement). 

Cette instruction n'a pas d'effet visible si on ['utilise en mode graphique haute resolution HGR2, 
meme si elle est precedee d'une instruction GR, du fait que I'ecran n'est pas en train de 
regarder la portion graphique basse resolution (page un) de la memoire. 

L'origine (0,0) de tous les graphiques est Tangle superieur gauche de I'ecran. 



HLIN 

HLIN imm & dif 

HLIN aexprl, aexpr2 AT aexpr3 

Utilise en mode graphique basse resolution, HLIN dessine une ligne droite allant de \aexprl \, 
\aexpr3 \ a \aexpr2 \, \aexpr3. La couleur est determinee par I'instruction COLOR executee la 
plus recente. 
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\aexpr 1 \ et aexpr2\ doivent etre sur l'etendue a 39 et \aexpr3\ doit etre sur l'etendue a 47 
sinon on regoit le message 

?ILLEGAL QUANTITY ERROR 
\aexpr 1 \ peut etre superieur, egal ou inferieur a /aexpr2 \. 

Si HLIN est utilise lorsque ce systeme est en mode TEXT ou en mode mixte graphique plus 
texte, avec \aexpr3 \ sur l'etendue 40 a 47, alors une ligne de caracteres se placera la ou la 
droite de points graphiques aurait du etre tracee. (Un caractere occupe I'emplacement de deux 
points basse resolution empiles verticalement). 

L'instruction n'a pas d'effet visible si on I'utilise en mode graphique haute resolution. 

Notez que le 'H' de cette instruction se refere a "horizontal" et non a "haute resolution". A 
I'exception de HLIN et HTAB, le prefixe "H" se refere aux instructions haute resolution. 

VLIN 

VLIN imm & dif 

VLIN aexprl, aexpr2, AT aexpr3 

En mode graphique basse resolution, cette instruction dessine une droite verticale allant de 
( \aexpr1 \ \aexpr3 \) a \aexpr2 \, \aexpr3 \ . La couleur est determinee par I'instruction COLOR 
executee la plus recente. 

\aexpr1 \ et \aexpr2 \ doivent etre sur l'etendue a 47, \aexpr3 \ doit etre sur la place a 39, 
sinon on recoit le message 

7ILLEGAL QUANTITY ERROR. 

\aexprl \ peut etre superieur, egal ou inferieur a \aexpr2. 

Si le systeme est en mode TEXT lorsqu'on utilise VLIN ou en mode mixte graphique plus texte, 
avec \aexpr2 \ sur l'etendue 40 a 47, la portion de la droite qui se trouve a I'interieur de la zone 
de texte apparaTtra sous forme d'une ligne de caracteres, placee la ou les points du graphique 
auraient ete traces. 

Cette instruction n'a pas d'effet visible si on I'utilise en mode graphique haute resolution. 

SCRN 

SCRN imm & dif 
SCRN (aexprl , aexpr2) 

En mode graphique basse resolution, la fonction SCRN fournit le code couleur du point dont la 
coordonnee X est \ aexpr 1 \ et dont la coordonnee y est \ aexpr2 \ 

Bien que le mode graphique basse resolution trace des points se trouvant aux positions de 
I'ecran (x, y) ou X est sur l'etendue a 39 et y sur l'etendue a 47, la fonction SCRN accepte a 
la fois des valeurs de X et y sur l'etendue a 47. Par contre, si SCRN est utilise avec une valeur 
X ( \aexpr1 \) sur l'etendue 40 a 47, le nombre fourni donne la couleur au point ou la 
coordonnee X est (\ aexpr \-40) et dont la coordonnee y est (\ aexpr2 \ + 16) Si (\aepr2 \ + 16) 
est sur l'etendue 39 a 47, en mode normal mixte graphique plus texte, le nombre fourni par 
SCRN est relatif au caractere du texte qui se trouve a la position de la zone de texte situee en- 
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dessous de la portion graphique de l'ecran. Si ( \ aexpr2 \ + 1 6) est dans la page 48 a 63, SCRN 
fournit un nombre qui n'a pas de relation avec I'ecran. 

En mode TEXT, SCRN fournit le nombre sur I'etendue a 15 dont la valeur est les quatre bits 
d'ordre superieur, si aexpr2 est impair; ou les quatre bits d'ordre inferieur, si aexpr2 est pair du 
caractere qui se trouve a la position de caractere (aexpr 1+1, INT «aexpr2+ 1) \ 211. Par 
consequent I'expression CHR $(SCRN(X-1, 2*(Y1))+16*SCRN(X-1,2*(Y-1)+1)) va donner le 
caractere qui se trouve a la position de caractere (X, Y). 

En mode graphique haute resolution SCRN a regarder la zone graphique basse resolution et 
done le nombre que fournit SCRN n'est pas relatif a I'affichage haute resolution. 

SCRN s'analyse comme mot reserve uniquement si le caractere suivant qui ne soit pas un 
espace blanc est une parenthese gauche. 

HGR 

HGR imm & dif 

Pas de parametres. Positionne le mode graphique haute resolution (280 par 160) pour I'ecran, 
en laissant quatre lignes pour le texte en bas de I'ecran, L'ecran est efface pour passer au noir 
et la page 1 de la memoire (8K-16K) est affichee. HCOLOR n'est pas modifie par cette 
instruction. La memoire de la partie de I'ecran reservee au texte n'est pas affectee. L'instruction 
HGR laisse la fenetre de texte sur la totalite de I'ecran mais seules les quatre lignes de texte 
inferieures sont visibles en-dessous du graphique Le curseur va encore etre dans la fenetre de 
I'ecran mais peut n'etre pas visible a moins qu'on ne le deplace vers I'une des quatre lignes 
inferieures. 

On peut convertir I'ecran en raphique sur la totalite de I'ecran (280 par 192) apres execution de 
HGR au moyen de l'instruction POKE 

POKE - 16302,0 
ou en utilisant 

POKE 49234,0 

qui est equivalent. Si HGR suit I'une ou I'autre des instructions POKE ci-dessus, on repositionne 
le mode mixte graphique haute resolution plus texte. 




Si le mot reserve HGR est utilise pour constituer les premiers caracteres d'un nom de variable, 
l'instruction HGR peut etre executee avant que n'apparaisse le message 

7SYNTAX ERROR. 
C'est ainsi que I'execution d'instruction 

HGRIP=4 

se traduit par un deplacement inattendu en mode graphique haute resolution qui peut effacer 
votre programme. 




Un tres long programme qui s'etend au-dela de I'emplacement de memoire 8192 peut etre 
partiellement efface lorsque vous executez HGR ou il peut venir "ecrire" sur votre page 1 de 
I'affichage graphique haute resolution. En particulier, les donnees en chaine sont memorisees 
en tete de la memoire; sur les systemes a faible capacite de memoire (16K ou 20K) ces 
donnees peuvent resider en page 1 du graphique haute resolution. Positionner HIMEM:8192 
pour proteger votre programme et la page 1 du graphique haute resolution. 
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HGR2 



HGR2 imm & dif 
HGR 

Pas de parametres. Cette instruction positionne le mode graphique haute resolution sur la 
totalite de I'ecran 1280 par 192). L'ecran est efface pour revenir au noir et la page 2 de la 
memoire (16K-24K) est affichee. La memoire de l'ecran correspondant au texte n'est pas 
affectee. Cette page de memoires (et done l'instruction HGR2) n'est pas disponible si votre 
systeme contient moins de 24K de memoire. 

Sur les systemes qui le permettent, I'utilisation de HGR2 au lieu de HGR rend maximum 
I'espace de memoire disponible pour les programmables. 

Sur les systemes a memoire de 24K, positionnez HIMEM: 16384 pour proteger la page 2 du 
graphique haute resolution de votre programme (en particulier les chaines qui sont memorisees 
en tete de la memoire). 




Si Ton utilise le mot reserve HGR2 pour constituer les premiers caracteres d'un nom de variable, 
l'instruction HGR2 peut s'executer avant que n'apparaisse le message 

7SYNTAX ERROR. 
Lorsqu'on I'execute, une instruction comme 

140 IFX> 150 THEN HGR2 PIECES = 12 
laisse l'ecran soudainement vierge, avec le risque que les parties superieures du programme ne 
soient effacees. 

L'instruction 

POKE - 16301,0 

convertit tout mode graphique plein ecran en mode mixte graphique plus texte. Si cette 
instruction est emise apres HGR2 toutefois, les quatre lignes de texte sont prises sur la page 2 
du texte, qui n'est pas facilement accessible a I'utilisateur. 

HCOLOR 

HCOLOR imm & dif 
HCOLOR = aexpr. 

Definit la couleur du graphique haute resolution comme etant celle specifee parla valeur de 
HCOLOR, qui 

doit etre dans I'etendue a 7 inclusivement. Les noms de couleur et leurs valeurs associees 
sont 

noir 1 4 noir 2 

1 vert (selon votre TV) 5 selon votre TV 

2 bleu (selon votre TV) 6 selon votre TV 

3 blanc 1 7 blanc 2. 




Un point haute resolution trace avec l'instruction HCOLOR=3 (blanc) sera bleu si la coordonnee 
X du point est paire, vert, si la coordonnee X est impaire et blanc uniquement si les deux (X, y) 
et (X+ 1 , y) sont traces. Ceci est d6 a la fagon dont travaille votre appareil TV. 
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HCOLOR n'est pas modifie par HGR, HGR2, OU RUN. Jusqu'a ce que la premiere instruction 
HCOLOR soit executee, la couleur de trace du graphique haute resolution est indeterminee. 
Si on I'utilise pendant que Ton est en mode graphique basse resolution, n'affecte pas la couleur 
a afficher. 

HPLOT 

HP LOT imm &, dif 
PLOT aexpr 1 , aexpr2 
HPLOT TO aexpr3, aexpr4 

HPLOT aexpr 1 , aexpr2 TO aexpr3, aexpr4 [{ TO aexpr, aexpr 1 }] 

HPLOT avec la premiere option trace un point haute resolution dont la coordonnee X est \aexpr 
1 \ et dont la coordonnee y est \aexpr2\ . La couleur du point est determinee par I'instruction 
HCOLOR executee la plus recente. La valeur de HCOLOR indeterminee si elle n'a pas ete 
precedemment specifiee. 

La seconde option amene le trace d'une droite partant du dernier point trace jusque ( \aexpr3\, 
\aexpr4 \). La couleur de cette ligne est determinee par la couleur du dernier point trace, meme 
si la valeur de HCOLOR a ete modifiee depuis ce trace precedent. Si aucun point precedent n'a 
ete trace, aucune droite n'est tiree. 

Si Ton utilise la troisieme option, une droite est tracee de (\aexpr1 \, \aexpr2 \) a ( \aexpr3 \, 
\aexpr4 \), avec la couleur specifier par I'instruction HCOLOR la plus recente. La droite ainsi 
tracee peut se prolonger dans la meme instruction presque indefiniment (sous reserve des 
limites de I'ecran et de la limite destruction de 239 caracteres) en prolongeant cette instruction 
avec 

to aexpr5, aexpr6 to aexpr7, aexpr8 et ainsi de suite. L'unique instruction 

HPLOT, 0,0 to 279, to 279, to 0, 159 to 0, 
peut tracer un bord rectangulaire tout autour des quatre cotes de I'ecran haute resolution. 



HPLOT doit etre precede de HGR ou HGR2 pour eviter de demolir des parties de la memoire, y 
compris votre programme et vos variables. 

\aexpr1 \ et \aexpr3 \ doivent etre sur I'etendue a 279. 

\aexpr2 \ et \aexpr4 \ doivent etre dans I'etendue a 1 91 . 

\aexpr1 \ peut etre superieur, egal ou inferieur a \aexpr3. \aexpr2 \ peut etre superieur, 

egal ou 

inferieur a \aexpr4. 

Un essai de trace a un point dont les coordonnees depassent ces limites amene le message 

7ILLEGAL QUANTITY ERROR. 
Si I'ecran se trouve en mode mixte graphique haute resolution plus quatre lignes de texte, un 
essai de trace des points avec des coordonnees y dans I'etendue 160 a 191 n'a pas d'effet 
visible. 

PDL 

PDL imm & dif 
PDL (aexpr) 

Cette fonction fournit la valeur en cours, de a 255, de la commande de jeux (ou PaDdLe) 
specifiee par \ aexpr \ si \ aexpr \ est dans I'etendue a 3. La commande de jeux est une 
resistance variable de a 150K ohms. 



GUIDE PRATIQUE DU BASIC ETENDU 79 



Si deux commandes de jeux sont lues dans des instructions PDL consecutives, la lecture de la 
seconde commande de jeux peut etre affectee par la lecture de la premiere. Pour avoir des 
lectures plus precises, il faut laisser plusieurs lignes de programme entre les instructions PDL 
ou placer une boucle a faible retard (FOR 1=1 TO 10:NEXT I) entre les instructions PDL. 

Si \ aexpr \ est negative ou inferieure a 225, on obtient le message 
7ILLEGAL QUANTITY ERROR. 




Si \ aexpr \ est sur I'etendue 4 a 225, la fonction PDL fournit un nombre plutot imprevisible de 
a 255 et peut causer differents effets par ailleurs, dont certains peuvent perturber I'execution du 
programme. 

Par exemple si \aexpr\ est sur I'etendue 204 a 219, I'emploi de la fonction PDL est, de fagon 
frequente et plutot aleatoire, accompagnee d'un cliquetis du hautparleur de I'ordinateur. 




Si N est sur I'etendue 236 a 239, PDL(N) peut resulter en une instruction 
POKE - 16540+N 

de sorte que PDL(236) peut positionner le mode graphique, que PDL(237) peut positionner le 
mode texte, etc. (voir appendix J). 

En plus de la lecture des positions de quatre commandes variables de jeux a I'aide de PDL, 
APPLESOFT peut lire I'etat de 3 boutons de commande de jeux (contacteurs on-off), a I'aide 
des differentes instructions PEEK et peut mettre en circuit et hors circuit 4 sorties de jeux 
(contacteurs TTL) a I'aide des differentes instructions POKE (voir appendix J). 
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CHAPITRE 9 

Formes haute resolution 



82 Comment creer une forme 

87 Pour sauvegarder un tableau de forme 

87 Pour utiliser un tableau de forme 

88 DRAW 
88 XDRAW 

88 ROT 

89 SCALE 
89 SHLOAD 
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Comment creer un tableau de forme 



APPLESOFT possede cinq instructions speciales qui vous permettent de manipuler des formes 
en graphiques haute resolution: DRAW, XDRAW, ROT, SCALE et SHLOAD. Avant de pouvoir 
utiliser ces instructions APPLESOFT, une forme doit etre definie par une "definition de forme". 
Cette definition de forme consiste en une sequence de vecteurs de trace qui sont memorises en 
une serie d'octets dans la memoire de APPLE. Une ou plusieurs de ces definitions de forme 
avec leur index, constituent un "tableau de forme" que Ton peut creer a partir du clavier et 
sauvegarder sur un disque ou un ruban sur cassette pour reemploi. 

Chaque octet de la definition de forme est divise en trois sections et chaque section peut 
specifier un "vecteur de trace": s'il y a ou non a tracer un point, ainsi que la direction de 
depassement (vers le haut, vers le bas, vers la gauche ou vers la droite). DRAW et XDRAW 
avancent section par section a travers chaque octet de la definition de forme, depuis le premier 
octet de la definition jusqu'a son dernier octet. 

Lorsque Ton atteint un octet qui ne contient que des zero, la definition de forme est terminee. 
Voici comment les trois sections, A, B et C sont disposees dans I'un des octets qui constituent 
une definition de forme: 
Section 



Numero debit Specifie " " 

Chaque paire de bit DD specifie une direction dans laquelle il faut se deplacer et chaque bit P 

specifie s'il faut ou non tracer un point avant de se deplacer, comme suit: 

Si DD = 00 deplacement vers le haut 

Si DD = H 1 deplacement vers la droite Si P = pas de trace 

Si DD = 10 deplacement vers le bas Si P = 1 trace. 

Si DD = 11 deplacement vers la gauche 

Notez que la derniere section, C (les deux bits de poids fort) ne possede pas de champ P (par 
defaut P = 01 de sorte que la section C ne peut specifier qu'un deplacement sans trace. 
Chaque octet peut representer jusque trois vecteurs de trace, un dans la section A, un dans la 
section B, et un troisieme (deplacement seulement) dans la section C. 
DRAW et XDRAW font progresser les sections de la droite vers la gauche (bit de poids faible 
vers bit de poids fort: section A, puis B, puis CI. A chaque section de I'octet, si toutes les 
sections restantes de I'octet ne contiennent que des zeros, alors ces sections sont ignorees. 
Done I'octet ne peut se terminer avec un deplacement dans la section C de 00 (e'est-a-dire un 
deplacement vers le haut sans trace) car cette section, ne contenant que des zeros, sera 
ignoree. De meme si la section C est 00 (ignoree), la section B ne peut pas etre un 
deplacement de 000 car elle serait egalement ignoree. Et un deplacement de 000 dans la 
section A terminera votre definition de forme a moins qu'il n'y ait un bit de valeur 1 quelque part 
dans la section B ou C. 

Supposons que vous voulez dessiner une forme comme celle-ci: 
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Tout d'abord dessinez-la sur un papier graphique, un point par carre. 
Puis decidez ou il faut commencer a dessiner la forme. Demarrons cette 
forme au centre. Puis dessinez un chemin passant par chaque point de 
la forme, en utilisant uniquement des angles a 90° aux virages: 











41 


4 








4 


4 
4 




4 




4 
4 


4 




± 







Puis redessinez la forme comme serie de vecteurs de trace, chacun 
representant un deplacement d'une place vers le haut, vers le bas, vers 
la droite et vers la gauche, et distinguez les vecteurs qui tracent un 
point avant le deplacement la gauche, et distinguez les vecteurs qui 
tracent un point avant le deplacement (un point rond repere les vecteurs 
qui tracent les points). 



Puis "deroulez" ces vecteurs et ecrivez-les sur une ligne droite: 

u ttti un 

Puis dessinez un Tableau comme celui de la Figure 1 ci-dessous: 



Section 
Octet 

i 


C 


B 


A 








2 




T 


t 


3 




i 


1 


4 








5 




t 




6 
7 






T 
t 


8 








9 









B 


A 


0T? 




0HT 


11 L 




1 1 1 


100 

m 




000 
100 


101 




101 


010 

1 1 




1 01 
t 1 


011 




1 1 






1 1 1 


000 




000 



t_Ce vecteur ne t 

peut pas indiquer un trace ou 
un deplacement vers le haut 



Vecteur 


Code 


t 


®w 

001 or 01 


T 


010 or 10 




011 or 11 


i 


100 
101 


T 


110 




111 


fin 



de la definition de forme. 



I Deplacement 
seulement 



1 Trace et 
deplacement 



Figure 1 



Pour chaque vecteur de la ligne, determinez le code en bits et placez le dans la section suivante 
disponible du tableau. Si le code ne s'adapte pas (par exemple le vecteur de la section C ne 
peut pas tracer un point) ou s'il y a un 00 (ou 000) a la fin d'un octet, alors sauter cette section 
et passer a la suivante. Lorsque vous avez termine de coder tous vos vecteurs, verifier votre 
travail pour voir si c'est bien precis. 
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Maintenant faites un autre tableau comme indique sur la figure 2, ci-dessous, et recopier les 
codes de vecteurs a partir du premier tableau. Recodez I'information concernant les vecteurs en 
une serie d'octets hexadecimaux, a I'aide du code hexadecimal de la figure 3. 




Hexadecimal: Chiffre 1 / chiffre 2 



Octet recodes 
en code hexadecimal 



Figure 2 



1 5 
3 6 
1 E 
7 

Indique la fin de 
la definition de forme 



Codes 
Binaire Hexadecimal. 



0001 
0010 
0011 
0100 
0101 
0110 
fllll 
000 
001 
010 
011 
100 
101 
110 
111 



Figure 3 



La serie d'octets hexadecimaux a laquelle vous arrivez figure 2 constitue la definition de forme. 
II y a encore un peu d'information supplemental que vous devez donner avant d'avoir un 
tableau de forme complet. La figure 4 de la page suivante represents le format d'un tableau de 
forme, complet avec son index. 

Pour cet exemple, votre index est facile: il n'y a qu'une seule definition de forme. L'emplacement 
de depart du tableau de forme dont nous avons appele I'adresse S doit contenir le nombre de 
definitions de forme (entre et 255) en hexadecimal. Dans ce cas, ce nombre est justement un. 
Nous allons placer notre definition de forme immediatement en-dessous de I'index pour 
simplifier. Ceci signifie dans ce cas que la definition de forme va commencer a I'octet S+4: 
I'adresse de la definition de forme n-1 relative a S, est 4 (00 04, en hexadecimal). Par 
consequent, I'octet S+2 de I'index doit contenir la valeur 04 et I'oc tel S+3 de I'index doit contenir 
la valeur 00. La figure 5 de la page suivante represente le tableau de forme complete pour cet 
exemple. 
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Depart = S 



Index f 



Octet 



S+0 
+1 
+2 
+3 
+4 
+5 



+2n 
+2n+l 



Definitions 
de forme 



S+D2 



n (0 to FF) 



Non utilise 



2 chiffres inferieurs 



2 chiffres superieurs 



2 chiffres inferieurs 



2 chiffres superieurs 



2 chiffres inferieurs 



2 chiffres superieurs 



Premier octet 



Dernier octet = 00 



Premier octet 



Dernier octet = 00 



First Byte 



Last Byte = 00 



Nombre total de definitions de forme 

Index correspondant au premier octet 
d i : de la definition de forme #1 par rap- 
port a S 

D2 : Index correspondant au premier octet 
de la definition de forme #2 par rap- 
port a S 



I Dn: Index correspondant au premier octet 
J de la definition de forme #n, par rap- 
port a S. 



Definition de forme #1 



> Definition de forme #2 



Definition de forme #n 



Figure 4 



Depart 
(adresse d'enregistrement 
en memoire dans E8 et E9) 



Octet 






01 


1 


00 


2 


04 


3 


00 


4 


12 


5 


3F 


6 


20 


7 


64 


8 


2D 


9 


15 


A 


36 


B 


IE 


C 


07 


D 


00 



_ Nombre de formes 

Index relatif a la definition de forme # 1 

- Premier octet P ar ra PP° rt au d eP art 



Definition de forme # 1 



Dernier octet. 



Figure 5 

Vous etes pret maintenant a taper le tableau de forme dans la memoire de APPLE. 
Premierement choisissez une adresse de depart. Pour cet exemple nous utilisons I'adresse 
hexadecimale IDFC. (Note: cette adresse doit etre inferieure a I'adresse de memoires la plus 
elevee disponible dans votre systeme et ne doit pas se trouver dans une zone qui sera effacee 
lorsque vous utiliserez HGR ou HGR2. L'emplacement 1 DFC se trouve juste en-dessous du 
graphique haute resolution page 1 utilise par HGR. Enfoncez la touche RESET pour entrer le 
programme Moniteur et tapez I'adresse de depart de votre tableau de forme: 
1 DFC 
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si vous enfoncez maintenant la touche RETURN, APPLE vous montrera I'adresse et le contenu 
de cette adresse. C'est-a-dire que vous examinez une adresse pour voir si vous y avez place le 
nombre correct. Si a la place vous tapez un deux points (:1 suivi d'un nombre hexadecimal de 
deux chiffres, ce nombre sera enregistre en memoire a I'adresse specifiee lorsque vous 
enfoncerez la touche RETURN. Essayez ceci: 
1 DFC return. 

Que donne APPLE comme contenu de l'emplacement 1 DFC ? Maintenant essayez ceci: 
1DFC:01 return 
1 DFC return 
1DFC-01 

APPLE dit maintenant que la valeur 01 (hexadecimale) est memorisee a l'emplacement dont 
I'adresse est 1 DFC. Pour memoriser plus de nombres hexadecimaux de deux chiffres dans les 
octets successifs en memoire, il suffit de declarer la premiere adresse 
1 DFC 

puis de taper les nombres, separes par des espaces blancs: 

1 DFC:01 00 04 001 2 3F 20 64 2D 1 5 36 1 E 07 00 return 

Vous venez de taper votre premier tableau de forme complet . . . ce n'est pas si mal, n'est ce 
pas? Pour verifier I'information qui se trouve dans votre tableau de forme, vous pouvez 
examiner chaque octet separement ou simplement enfoncer la touche RETURN de fagon 
repetitive jusqu'a ce que tous les octets interessants let quelques uns supplementaires, sans 
doute) aient ete affiches: 

1 DFC return 
1DFC-01 

* return 
00 04 00 

* return 

1E00- 12 3F20 64 2D 15 36 1 E 

* return 

1 E08- 07 00 DF 1 E 23 00 00 FF 

Si votre tableau de forme vous semble correct, tout ce qui reste a faire est d'enregistrer 
I'adresse de depart du tableau de forme a un endroit ou APPLESOFT peut la trouver (ceci se 
fait automatiquement si vous utilisez SHLOAD pour avoir APPLESOFT cherche les quatre 
chiffres hexadecimaux de I'adresse de depart du tableau aux emplacements hexadecimaux E8 
(deux chiffres inferieurs) et E9 (deux chiffres superieurs). Pour notre adresse de depart de 
tableau de ID FC, ceci va donner: 

E8: FC 1 D return. 

Pour proteger votre tableau de forme d'un effacement accidentel par votre programme 
APPLESOFT, cela pourrait etre egalement une bonne idee de positionner HIMEM (dans les 
emplacements hexadecimaux 73 et 74) correspondant a I'adresse de depart du tableau: 

73: FC 1 D 

Ceci se fait egalement automatiquement lorsque vous utilisez SHLOAD pour avoir le tableau a 
partir de la bande sur cassette. 
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Pour sauvegarder un tableau de forme 



Pour sauvegarder votre tableau de forme sur une bande, vous avez besoin de connaitre trois 
choses: 

1) adresse de depart du tableau 1DFC, dans votre exemple) 

2) derniere adresse du tableau (1E09, dans votre exemple) 

3) difference entre 2) et 1) (000D, dans votre exemple). 

L'item 3, difference entre la derniere adresse et la premiere adresse du tableau doit etre 
enregistre aux emplacements hexadecimaux (deux chiffres inferieurs) et t (deux chiffres 
superieurs): 

0: 0D 00 return. 

Maintenant vous pouvez ecrire (enregistrer sur cassette) d'abord la longueur du tableau qui est 
enregistre aux emplacements et 1, puis le tableau de forme lui-meme qui est enregistre aux 
emplacements adresse de depart a derniere adresse: 

0.1 W 1DFC. 1E09W. 

N'enfoncez pas la touche return avant d'avoir place une cassette dans votre enregistreur de 
cassette, I'avoir rembobinee et avoir commence I'enregistrement (enfoncer PLAY et RECORD 
simultanement). Maintenant enfoncez la touche RETURN de I'ordinateur. 
Pour utiliser la bande, rembobinez 1a, commencez a I'ecouter (enfoncez) et (en APPLESOFT 
maintenant) tapez: 

SHLOAD return. 

Vous devriez entendre un bip lorsque la longueur du tableau a ete lue avec succes et un autre 
bip lorsque le tableau lui meme a ete lu. 

Pour utiliser un tableau de forme 



Vous etes pret maintenant a ecrire un programme APPLESOFT en utilisant les instructions de 
tableau de forme DRAW, XDRAW, ROT et SCALE. 

Voici un programme echantillon APPLESOFT qui va imprimer notre forme definie, la faire 
tourner de 16°et la repeter, APPLESOFT repetition etant plus grande que la precedente. 
10 HGR 

15 POKE - 16302,0 ou 49234.0 20 HCOLOR = 3 

30 FOR R = 1 TO 50 

40 ROT = R 

50 SCALE = R 

60 DRAW 1 AT 139, 79 

70 NEXT R 

Pour voir un unique carre, ajouter une ligne 
65 END. 

Pour arreter puis effacer chaque carre apres qu'il ait ete dessine, ajoutez ces lignes 

63 FOR l=0 TO 1000: NEXT I 
65 XDRAW 1 AT 139, 79 
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DRAW 



DRAW imm & dif - 

DRAW aexpr I AT aexpr2, aexpr3 DRAW aexpr I 

DRAW avec la premiere option dessine une forme en graphique haute resolution en 
commengant au point dont la coordonnee X est \aexpr2 \ et dont la coordonnee y est \aexpr3 \ . 
La forme dessinee est la definition de forme d'ordre \aexpr 1 \ du tableau de forme 
precedemment charge a I'aide de I'instruction SHLOAD (ou un tableau de forme peut etre dans 
la memoire de APPLE en code hexadecimal en utilisant le programme Moniteur). 

\ aexpr 1 \ doit etre sur I'etendu a n, ou est le nombre (de a 255) de definitions de forme 
donne dans I'octet du tableau de forme, \aexpr2 \ doit etre sur I'etendue a 278. \aexpr3 \ doit 
etre sur I'etendue a 191. Si I'une ou I'autre de ces etendues est depassee, on obtient le 
message ? 

ILLEGAL QUANTITY ERROR. 
La couleur, la rotation et I'echelle de la forme a dessiner doivent avoir ete specifiers avant 
execution de I'instruction DRAW. 

La seconde option est semblable a la premiere mais dessine la forme specifiee en commengant 
au dernier point trace par I'instruction HPLOT, DRAW ou XDRAW executee en dernier lieu. 

Si I'instruction DRAW est emise quand il n'y a pas de tableau de forme dans I'ordinateur, elle 
peut amener le systeme en suspens. Pour le recuperer, utilisez reset Ctrl C return. Cette 
instruction peut egalement dessiner des formes aleatoires sur toute la zone de graphique haute 
resolution de la memoire, en risquant de detruire votre programme meme si vous n'etes pas en 
mode graphique. 

XDRAW 



XDRAW imm & dif 

XDRAW aexpr I [AT aexpr2, aexpr3] 

Cette instruction est la meme que DRAW a I'exception que la couleur utilisee pour dessiner la 
forme est lie complement de la couleur deja existante a chaque point trace. Les couples de 
couleur suivants sont complementaires : 

noir et blanc 

bleu et vert. 

Le but de XDRAW est de fournir un moyen simple pour effacer: si vous appliquez I'instruction 
XDRAW a une forme vous effacerez la forme sans effacer le fond. 




Voir les remarques de precautions a prendre pour DRAW. 

ROT 



ROT imm & dif 
ROT = aexpr 

Definit une position angulaire pour le forme a dessiner par les instructions DRAW ou XDRAW. 
La valeur de la rotation est specifiee par \aexpr \, qui doit etre entre et 255. 
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ROT=0 fait que la forme a dessiner est orientee juste comme elle a ete definie, ROT= 16 fait 
que la forme a dessiner tourne de 90° sens d'horloge, ROT=32 fait que la forme a dessiner 
tourne de 180° sens d'horloge, etc. Le processus se repete a partir de ROT= 64. Pour SCALE= 
1 quatre valeurs de rotation seulement sont reconnues (0, 16, 32, 481; pour SCALE= 2, huit 
rotations sont reconnues, etc. Des valeurs de rotation non reconnues donnent a la forme a 
dessiner I'orientation de la derniere rotation reconnue la plus faible (habituellement). 
ROT s'analyse comme mot reserve uniquement si le caractere suivant autre qu'un espace blanc 
est le signe de remplacement (=). 

SCALE 

SCALE imm & dif 
SCALE = aexpr 

Definit la dimension de I'echelle pour la forme a dessiner par les instructions DRAW ou XDRAW 
avec un facteur qui va de 1 (reproduction point pour point de la definition de formel a 255 
(chaque vecteur est agrandi 255 fois) comme specifie par \aexpr \ . NOTE: SCALE =0 est la 
taille maxima et non pas un simple point. 

SCALE s'analyse comme mot reserve uniquement si le caractere suivant qui ne soit pas un 
espace blanc est le signe de remplacement (=1. 

SHLOAD 

SHLOAD imm & dif 
SHLOAD 

Charge a tableau de forme a partir d'une bande sur cassette. Le tableau de forme est charge 
juste en-dessous de HIMEM: et HIMEM: est repositionne juste en-dessous du tableau de forme 
pour le proteger. L'adresse de depart du tableau de forme est donnee automatiquement aux 
routines de dessin de forme de APPLESOFT. Si on charge un second tableau de forme, qui 
remplace le premier, HIMEM doit etre repositionne avant le chargement pour eviter de gacher 
de la memoire. Les bandes du tableau de forme sont preparees a I'aide des instructions 
donnees au debut de ce chapitre. 

Sur le systeme a 16K de memoire, HGR efface les 8K superieurs de la memoire, de 
remplacement 8192 a remplacement 16383. Pour obliger SHLOAD a placer le tableau de forme 
en-dessous de la page 1 du graphique haute resolution, positionnez HIMEM: 8192 avant 
d'executer I'instruction SHLOAD. Sur le systeme a 24K de memoire, n'utilisez pas HGR2 (qui 
efface la memoire de remplacement 16384 a remplacement 245751, ou positionnez HIMEM: 
16384 avant d'executer I'instruction SHLOAD et n'utilisez pas HGR. Si vous etes certain qu'il y a 
encore suffisamment de memoires sure au-dessus de remplacement 24575 pour contenir votre 
tableau de forme, il n'y a pas a vous inquieter. 

On peut interrompre SHLOAD qu'avec reset. Si le mot reserve SHLOAD commence a un nom 
de variable, I'instruction relative au mot reserve peut etre executee avant d'avoir un message 
d'erreur 

?SYNTAX ERROR. 
L'instruction 

SHLOADER=59 

suspend le systeme pendant que APPLESOFT attend indefiniment le programme en 
provenance du lecteur de cassette. Pour reprendre le controle de I'ordinateur, utilisez reset Ctrl 
C. 
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CHAPITRE 10 

Fonctions mathematiques 

Fonctions incorporees . . 

92 SIN, COS, TAN, ATN, INT, RND, SGN, ABS, SQR, EXP, LOG. 

93 Fonctions derivees. 
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Fonctions incorporees 

Toutes les fonctions peuvent s'utiliser partout ou une expression du meme type peut s'utiliser. 
Elles peuvent s'utiliser en execution soit immediate, soit differee. Voici une breve description de 
certaines des -fonctions arithmetiques de APPLESOFT. D'autres fonctions sont decrites dans 
les sections qui pretent des instructions similaires. 

SIN (aexpr) 

Donne le sinus de \aexpr\ radians. 



COS (aexpr) 

Donne le cosinus de \aexpr\ radians. - 



TAN (aexpr) 

Donne la tangente de \aexpr\ radians. 



ATN (aexpr) 

Donne I arc tangente radians de \aexpr \. L'angle donne est sur I'etendue -pi/2 a +pi/2 radians. 



INT (aexpr) 

Donne le plus grand entier inferieur ou egal a \aexpr\. 



RND (aexpr) 

Donne un nombre reel aleatoire superieur ou egal a zero et inferieur a 1. Si \aexpr\ est 
superieur a zero, RND (aexpr) donne un nouveau nombre aleatoire a chaque nouvelle 
utilisation. 



Si \aexpr\ est inferieur a zero, -donne le meme nombre aleatoire chaque fois qu'on I'utilise avec 
le meme \aexpr\, comme s'il provenait d'un tableau permanent de nombres RDN (aexpr) 
incorpore dans APPLE. Si on utilise un argument negatif particulier pour generer un nombre 
aleatoire, alors les nombres aleatoires successifs engendres avec des arguments positifs vont 
suivre le meme ordre chaque fois. Un ordre aleatoire different est initialise par chaque nouvel 
argument negatif different. La raison principale d'utiliser un argument negatif pour RND est done 
d'initialiser une sequence repetitive de nombres aleatoires. Ceci est particulierement utile pour 
la mise au point des programmes qui utilisent RND. 

Si \aexpr \ est zero, RND donne le nombre aleatoire precedent le plus recent genere (les 
instructions CLEAR et NEW n'affectent pas ceci). Parfois ceci est plus facile que d'assigner le 
dernier aleatoire a une ,i variable pour le sauvegarder. 

SGN (aexpr) 

Donne - 1 si \ aexpr \ <0, donne si \ aexpr \ =0 et donne 1 si \ aexpr \ >0 
ABS (aexpr) 

Donne la valeur absolue de \aexpr\, e'est-a-dire \aexpr\ si \aexpr\>=0 et -\aexpr\ si \aexpr \ <0. 
SQR (aexpr) 

Donne la racine carree positive. C'est une execution speciale qui opere plus rapidement que 
A .5. 
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EXP (aexgr) 

Eleve (avec decimales, e = 2.718289) a la puissance indiquee, \aexpr\. 
LOG (aexpr) 

Donne le logarithme naturel de \aexpr\ . 



Fonctions derivees 



Les fonctions suivantes, bien que ne faisant pas intrinsequement partie de APPLESOFT BASIC, 
peuvent se calculer a I'aide des fonctions BASIC existantes et peuvent s'utiliser facilement a 
i'aide de la fonction DEF FN. 

SECANTE: 

SEC (X) = 1 /COS(X) 

COSECANTE: 

CSC(X) = 1 /SIN(X) 

COTANGENTE: 

COT(X) = 1 /TAN(X) 

ARC SINUS: 

ARCSIN(X) = ATN(X/SQR(-X*X+1)) 
ARC COSINUS: 

ARCCOS(X) = ATN(X/SQR(-X*X+ 111+ 1 .5708 
ARC SECANTE: 

ARSEC(X) = ATN(SQR(X*X-1))+(SGN(X)-1)*1.5708 
ARC COSECANTE: 

ARCCSC(X) = ATN(1/SQR(X*X-1))+(SGN(X)-1)'1.5708 

ARC COTANGENTE 

ARC COT(X) _ -ATNIXI+ 1 .5708 

SINUS HYPERBOLIQUE 

(SINH(X) = (EXP(X)-EXP(-X))/2 
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COSINUS HYPERBOLIQUE: 

COSH(X) = (EXP(X)+EXP(-X))/2 

TANGENTE HYPERBOLIQUE: 

TANH(X) _ -EXPI-XI/IEXPIXI+EXPI-X1 1"2+1 

SECANTE HYPERBOLIQUE 
SECH(X) = 2/(EXP(X)+EXP(-X)) 

COSECANTE HYPERBOLIQUE 
CSCH(X) = 2/(EXP(X)-EXP(-X)) 

COTANGENTE HYPERBOLIQUE: 
COTH(X) = EXP(-X)-EXP(-X)*2+ 1 

ARC SINUS HYPERBOLIQUE 
ARGSINH(X) = LOG(X+SQR(X*X+1)) 

ARC COSINUS HYPERBOLIQUE: 
ARGCOSH(X) = LOG(X+SQR(X*X-1)) 

ARC TANGENTE HYPERBOLIQUE 
ARGTANH(X) = LOG(1+X)/(1-X))/2 

ARC SECANTE HYPERBOLIQUE: 
ARGSECH(X) = LOG((SQR(-X*X+1)+1)/X 

ARC COSECANTE HYPERBOLIQUE 
ARGCSCH(X) = LOG(SGN(X)*SQR(X*X+1)+1)/X 

ARC COTANGENTE HYPERBOLIQUE 
ARGCOTH(X) = LOG(X+1)/(X-1))/2 

A MOD B 

MOD(A) = INT((A/B)*B+.05)*SGN(A/B) 
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Pour avoir APPLESOFT/BASIC pret a passer 



APPLE Computer Inc. offre deux versions du langage de programmation BASIC. Integer 
BASIC, decrit dans le manuel de programmation APPLE II BASIC, est un BASIC tres rapide 
convenant pour de nombreuses applications, particulierement pour I'enseignement des jeux et 
des graphiques, I'autre version de BASIC s'appelle "APPLESOFT" et convient mieux pour de 
nombreuses applications d'affaires et scientifiques. 

APPLESOFT BASIC est disponible en deux versions. La programmation APPLESOFT vient, 
avec APPLESOFT en memoire ROM, sur une carte de circuit imprime (n de piece APPLE 
A2B0009X) qui s'enfiche directement dans APPLE II. Avec cette option il suffit de faire 
commuter un commutateur et d'enfoncer deux touches pour que APPLE II commence a 
fonctionner en APPLESOFT. En plus de cette commodite, le fait d'avoir APPLESOFT en 
memoire ROM vous economise environ 10 K de memoires et vous economise le temps de 
chargement du langage a chaque utilisation a partir de la cassette. L'essentiel de ce manuel 
suppose que vous disposez de la carte de programmation APPLESOFT. Si vous utilisez la 
version cassette APPLESOFT, voyez la partie 2 de cet appendice pour les instructions 
speciales et notez ou votre APPLESOFT differe de celui decrit dans le reste de manuel. 

Note: dans ce manuel le mot reset (mettre a I'etat initial) signifie enfoncer la touche marquee 
RESET, 1 e mot RETURN signifie enfoncer la touche marquee RETURN et Ctrl B signifie taper 
B tout en maintenant enfoncee la touche marquee CTRL. 

Note importante: 

Une des fonctions du caractere indicateur, en plus de vous indiquer d'avoir a entrer une donnee 
dans I'ordinateur est d'identifier d'un coup d'oeil quel est le langage pour lequel I'ordinateur est 
programme a repondre a tout moment. Par exemple jusqu'ici vous avez vu deux caracteres 
indicateurs. 

* pour le programme moniteur (lorsque vous enfoncez RESET) 
> pour Integer BASIC (le integer BASIC normal) 
Nous introduisons maintenant un troisieme caractere indicateur: 
] pour APPLESOFT a virgule flottante. 

En regardant simplement ce caractere vous pouvez facilement savoir (si vous I'avez oublie) 
dans quel langage travaille I'ordinateur. 
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P ARTIE 1: programmation 



Pour installer la carte APPLESOFT 

La carte de programmation APPLESOFT s'enfiche simplement dans un support qui se trouve 
dans APPLE II. 

Ill vous faut prendre soin toutefois de suivre exactement ces instructions: 

1 . Mettre APPLE hors-circuit: tres important pour eviter d'endommager I'ordinateur 

2. Enlever le couvercle de APPLE II. Ceci se fait en tirant sur le couvercle au bord 
arriere (le bord le plus eloigne du clavier) jusqu'a ce que les deux agrafes d'angle se 
separent. A ce moment la ne continuez pas a soulever le bord arriere mais faites 
glisser le couvercle vers I'arriere jusqu'a qu'il soit libre. 

3. A I'interieur de APPLE I I, a I'arriere du panneau de circuit, il y a une file de huit 
supports etroits nommes "Slots". Le plus a gauche (en regardant I'ordinateur depuis 
I'extremite du clavier) est le slot #0; le plus a droite est le slot #7. Tenir la carte 
APPLESOFT de facon que ces contacts se trouvent diriges vers I'arriere de 
I'ordinateur; inserer la portion de la carte presentant des contacts dans le slot le plus a 
gauche slot #0. Les contacts penetrent dans le slot en frottant un peu puis prennent 
bien leur place. La carte APPLESOFT doit etre placee dans le slot #0. 

4. Les contacts qui se trouvent a I'arriere de la carte APPLESOFT doivent depasser 
partiellement par la fente a I'arriere de APPLE II. 

5. Remettre le couvercle de APPLE: faire glisser d'abord le bord avant en place puis 
appuyer sur les deux angles arrieres jusqu'a ce qu'ils viennent se clipser en place. 

6. Puis remettre APPLE II en circuit. 



Pour utiliser le panneau de programmation APPLESOFT 

L'interrupteur de la carte APPLESOFT etant en position vers le bas, APPLE II va commencer a 
marcher en Integer BASIC lorsque vous effectuez I'operation reset Ctrl B (c'est la fagon de ce 
manuel de dire: enfoncez la touche marquee RESET puis maintenez enfoncee la touche 
marquee CTRL tout en tapant B.) Vous verrez le caractere > qui indique Integer BASIC. 

Lorsque le contact de la carte APPLESOFT est en position vers le haut, en effectuant 
I'operation reset Ctrl B vous amenez APPLESOFT BASIC au lieu de Integer BASIC. Le 
caractere ] vous dit que vous etes en APPLESOFT. 

Lorsque vous utilisez le systeme d'exploitation a disque, I'ordinateur choisira automatiquement 
Integer ou BASIC APPLESOFT selon necessite. Independamment de la position de 
l'interrupteur. 

Vous pouvez egalement passer de Integer BASIC a APPLESOFT ou vis-versa sans manceuvrer 
contact de la carte-de programmation. Pour mettre I'ordinateur en APPLESOFT, utilisez 

reset C080 return Ctrl B return 

et pour mettre I'ordinateur en Integer BASIC, utilisez 

reset C081 return 
Ctrl B return. 
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AUTRE NOTE IMPORT ANTE 

II peut arriver d'appuyer accidentellement la touche RESET et de vous trouver dans le moniteur, 
comme indique par le caractere'. Vous pouvez alors revenir a APPLESOFT BASIC, avec 
APPLESOFT et votre programme intact, en tapant Ctrl C return. 

PARTIE 2: bande cassette APPLESOFT 

APPLE II BASIC est livre sur cassette, sans frais, avec chaque APPLE II. APPLESOFT BASIC, 
charge a partir de la cassette, occupe environ 10 K octets de memoire il faut done un ordinateur 
de 1 6 K octets ou plus de memoires pour utiliser la version cassette de APPLE 1 1 BASIC. 

Pour mettre en route APPLESOFT sur cassette 

Utilisez la procedure suivante pour charger APPLESOFT a partir de votre lecteur de cassettes. 

1. Mettez en route Integer BASIC en tapant reset Ctrl B. Si vous n'etes pas familiarise 
avec cette procedure, voyez votre manuel de programmation Integer BASIC APPLE. 
Vous saurez que vous etes en Integer BASIC lorsque vous verrez le caractere 
souffleur > affiche sur votre ecran TV, suivi du carre clignotant "curseur". 

2. Place le ruban APPLESOFT (numero de piece A2T0004 sur votre lecteur de cassette 
et rembobinez le ruban jusqu'au debut. 

3. Tapez LOAD. 

4. Enfoncez la touche "play" de votre lecteur de cassette pour commencer la lecture du 
ruban. 

5. Enfoncez la touche marquee RETURN sur le clavier de APPLE II. Lorsque vous le 
faites, le curseur clignotant va disparaTtre. Apres 5 a 20 secondes APPLE II va 
emettre un bip, pour signaler que I'information qui se trouve sur le ruban a commence 
a entrer dans I'ordinateur. Apres environ 1 12 minutes il y aura un autre bip et le 
caractere souffleur > suivi d'un curseur va reapparaTtre. 

6. Arretez le lecteur de cassette et rembobinez le ruban. APPLESOFT se trouve 
maintenant dans I'ordinateur. 

7. Tapez RUN et enfoncez la touche marquee RETURN. L'ecran va afficher la notice 
copyright pour APPLESOFT II et le caractere souffleur de APPLESOFT ]. 



II peut vous arriver de toucher accidentellement la touche et de vous retrouver sur le 
programme moniteur, comme indique par le caractere souffleur Integer BASIC. Vous pouvez 
revenir alors a APPLESOFT, votre programme et APPLESOFT eux-memes restart intacts, en 
tapant 

0G return. 

Si ceci n'agit pas, il vous faudra recharger APPLESOFT a partir du ruban sur cassette. 

Le fait de taper Ctrl C ou Ctrl B a partir du programme moniteur vous transfere sur Integer BASIC 

APPLE; ceci va effacer APPLESOFT. 

Dans ce manuel reset (mettre a I'etat initial) signifie enfoncer la touche marquee RESET, return 
signifie enfoncer la touche marquee RETURN et Ctrl B signifie taper B tout en maintenant 
enfoncee la touche marquee CTRL. 
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Differences entre APPLESOFT en programmation et APPLESOFT sur 
cassette 

APPLESOFT sur ruban en cassette (n de piece A2T6604) ne travaille pas exactement de la 
meme fagon que la version programmation de APPLESOFT. Les commentaires suivants attirent 
I'attention sur la fagon dont APPLESOFT cassette differe de APPLESOFT en programmation. 

Du fait que APPLESOFT sur cassette occupe environ 10 K de memoire (et que I'ordinateur 
utilise par ailleurs 2 K), il n'est pas possible d'utiliser APPLESOFT sur cassette sur des 
ordinateurs APPLE de moins de 16 k de memoire. APPLESOFT sur cassette etant charge, le 
plus faible emplacement de memoire disponible pour I'utilisateur est d'environ 12.300. 
APPLESOFT en programmation ne reside pas en memoire RAM, de sorte qu'il est possible de 
I'utiliser (sans graphiques haute resolution), dans des systemes plus petits. 



HGR/le graphique haute resolution n'est pas disponible dans APPLESOFT sur cassette. 
L'instruction HGR efface "la page 1" de la memoire de graphique (8 K sur 16 K) en faveur du 
graphique haute resolution. Du fait que APPLESOFT sur cassette occupe partiellement cette 
portion de memoire, le fait d'essayer d'utiliser HGR va effacer APPLESOFT et peut effacer votre 
programme. L'instruction HGR 2 peut etre utilisee a la fois en memoire ROM et dans les 
versions sur cassette de APPLESOFT mais n'est disponible que si votre APPLE contient au 
moins 24 K de memoire. Done sur un systeme de moins de 24 K de memoire, APPLESOFT sur 
cassette n'offre pas la possibility du graphique haute resolution. 

L'instruction 

POKE - 16301,0 

convertit tout mode graphique sur la totalite de I'ecran en un mode mixte graphique plus texte. 
Lorsque cette instruction est emise apres HGR 2, toutefois, les quatre lignes de texte sont 
prises sur la page 2 de la memoire de texte. Dans la version sur cassette de APPLESOFT, 
APPLESOFT lui-meme occupe la page 2 de la memoire de texte, de sorte que Ton ne peut pas 
disposer de la possibility graphique haute. 

Avec Integer Basic et avec Applesoft sur la carte programmation, vous pouvez revenir a votre 
programme apres avoir enfonce accidentellement ou intentionnellement la touche RESET, en 
utilisant Ctrl C return. Pour accomplir la meme chose avec APPLESOFT sur cassette, vous 
devez utiliser 0G return (taper 0, puis taper G et enfoncer la touche RETURN). Si vous utilisez 
APPLESOFT sur cassette, reset Ctrl C return (enfoncer la touche RESET puis enfoncee la 
touche C tout en maintenant enfoncee la touche, puis enfoncer la touche), va reinstaller Integer 
BASIC comme votre langage de programmation; ceci va effacer APPLESOFT. 

En bref, chaque fois que ce manuel ok dit d'utiliser 
reset Ctrl C return 

les utilisateurs de APPLESOFT sur cassette doivent utiliser a la place reset 0G return (enfoncer 
la touche RESET, puis la touche 0, puis la touche G, puis la touche RETURN. 

Lorsque le manuel dit d'utiliser reset Ctrl B return vous pouvez le faire mais vous aurez a 
recharger APPLESOFT a partir de la bande sur cassette. 

Avec APPLESOFT sur cassette, il vous faut utiliser l'instruction CALL 11246 (a la place de 
l'instruction CALL 62450) pour effacer I'ecran apres une instruction HGR2 et le ramener au noir. 
II faut utiliser l'instruction CALL 11250 (a la place de l'instruction CALL 62454) pour effacer 
I'ecran apres une instruction HGR2 et le ramener a la couleur definie par la derniere instruction 
HPLOT. Si ces differentes instructions sont executees avant la premiere emission de 
l'instruction HGR2 elles peuvent effacer APPLESOFT. 
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APPENDICE B 

Pour editer un programme 

II arrive generalement aux hommes de faire des erreurs a I'occasion . . . particulierement en 
ecrivant des programmes d'ordinateur. Pour faciliter la correction de ces bevues, APPLE a 
incorpore un jeu inedit de caracteristiques d'edition dans APPLESOFT BASIC. 

Pour les utiliser, il vous faut d'abord familiariser avec les fonctions de quatre touches speciales 
du clavier APPLE II. Ce sont la touche escape, la touche marquee ESC, la touche repeat, la 
touche marquee REPT et les touches fleche a gauche, fleche a droite qui sont marquees d'une 
fleche a gauche et d'une fleche a droite. 

ESC 

La touche escape (ESC) est la touche la plus a gauche de la seconde rangee en partant du 
haut. Elle s'utilise toujours avec une autre touche (par exemple comme les touches A, B, C ou 
D) de cette fagon: enfoncer et relacher ESC puis enfoncer et relacher A, par exemple . . . 
alternativement. 

Cette operation ou sequence de la touche ESC et d'une autre touche s'ecrit sous la forme 
"escape A". II existe quatre fonctions escape utilisees pour I'edition: 

escape A deplace le curseur vers la droite, 
escape B deplace le curseur vers la gauche, 
escape C deplace le curseur vers la bas, 
escape D deplace le curseur vers le haut. 

En utilisant la touche escape et la touche desiree, on peut deplacer le curseur en n'importe quel 
endroit de I'ecran sans affecter ce qui est deja affiche et sans affecter ce qui se trouve en 
memoire. 

TOUCHE FLECHE A DROITE 

La touche fleche a droite deplace le curseur vers la droite. C'est la touche du clavier qui 
economise le plus de temps car elle ne fait pas que deplacer le curseur mais elle recopie dans 
la memoire de APPLE II tous les caracteres et symboles sur lesquels passe le curseur, 
exactement comme si vous les aviez tape vous-meme au clavier. L'affichage TV n'est pas 
modifie lorsque vous utilisez la touche fleche a droite. 

TOUCHE FLECHE A GAUCHE 

La touche fleche a gauche deplace le curseur vers la gauche. Chaque fois que le curseur se 
deplace vers la gauche, un caractere est efface dans la ligne de programme que vous etre en 
train de taper, independamment du caractere sur lequel passe le curseur. L'affichage TV n'est 
pas modifie lorsque vous utilisez la touche fleche a gauche. Habituellement la touche fleche a 
gauche ne peut pas s'utiliser pour deplacer le curseur dans la colonne la plus a gauche: il faut 
pour cela utiliser escape B. 

REPT 

La touche REPT s'utilise avec une autre touche de caractere du clavier. Elle fait que ce 
caractere se repete aussi longtemps que Ton maintient enfoncees la touche de caractere et la 
touche REPT. 

Maintenant vous etes pret a utiliser ces fonctions d'edition pour vous economiser du temps pour 
faire des modifications ou des corrections a votre programme. Voici quelques exemples de la 
fagon de les utiliser: 
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Exemple 1 - Pour corriger les erreurs de frappe: 

Supposons que vous ayez entre un programme en le tapant et lorsque vous voulez le faire 
passer I'ordinateur imprime SYNTAX ERR et s'arrete en vous presentant le caractere indicateur 
1 et le curseur clignotant. 

Entrez le programme suivant et faites le passer. Notez que c'est volontairement que Ton a mal 
orthographie "PRINT" et "REGRAM". Voici approximativement ce qui va apparaTtre sur votre 
ecran TV: 

]10 PRIMT "THIS IS A PREGRAM" 
]20 GOTO 10 
] RUN 

? SYNTAX ERR IN 10 
I 

Maintenant tapez le mot LIST et enfoncez return. 

] LIST 

10 PRIMT "THIS IS A PREGRAM" 
20 GOTO 10 
I 

Pour deplacer le curseur vers le haut au debut de la ligne 10, tapez escape D trois fois puis 
tapez escape B. Note: II est important d'utiliser escape B pour placer le curseur exactement sur 
le premier chiffre du numero de la ligne. L'ecran TV va apparaTtre comme suit: 

] LIST 

|0 PRIMT "THIS IS A PREGRAM" 
20 GOTO 10 

Maintenant enfoncez 6 fois la touche fleche a droite pour deplacer le curseur sur la lettre M de 
'PRIMT'. 

N'oubliez pas que lorsque la touche fleche a droite deplace le curseur en passant sur un 
caractere sur l'ecran, ce caractere est copie dans la memoire de APPLE exactement comme si 
vous I'aviez tape au clavier. 
Votre ecran TV apparaTt comme suit: 

] LIST 

10 PRl|T "THIS IS A PREGRAM" 
20 GOTO 10 

] 

Maintenant tapez la lettre N pour corriger I'orthographe de "PRIMT", puis copiez (a I'aide de la 
touche fleche a droite et de la touche REPEAT) en allant jusqu'a la lettre E de "PREGRAM". 
Votre ecran TV va donner ce qui suit: 

] LIST 

10 PRINT "THIS IS A PR|GRAM" 

20 GOTO 10 

] 



GUIDE PRATIQUE DU BASIC ETENDU 101 



Si vous tapez la touche fleche a droite trop souvent en maintenant enfoncee la touche repeat 
trap longtemps, utilisez la touche fleche a gauche pour revenir en arriere sur la lettre E. 
Maintenant tapez la lettre pour corriger 'PR EGRAM' et copiez a I'aide de la touche fleche a 
droite jusqu'a la fin de la ligne 10. Enfin, enregistrez en memoire du programme, la nouvelle 
ligne en enfongant la touche RETURN. 

Tapez LIST pour voir votre programme corrige: 

] LIST 

10 PRINT "THIS IS A PROGRAM" 
20 GOTO 10 
I 

Maintenant faites passer (instruction RUN) le programme ( utilisez Ctrl C pour arreter le 
programme) 

] RUN 

THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
THIS IS A PROGRAM 
BREAK IN 10 
I 

Exemple 2 - Pour inserer un texte dans une ligne existante 

Dans I'exemple precedent, supposons que vous souhaitiez inserer une instruction TAB(10) 
apres le PRINT de la ligne 10. Voici comment vous pouvez le faire. D'abord affichez la ligne a 
modifier (instruction LIST): 

]LIST 10 

10 PRINT "THIS IS A PROGRAM" 
I 

Tapez D escape D et un escape B jusqu'a ce que le curseur soit exactement sur le premier 
caractere de la ligne a modifier; puis utilisez les touches fleche a droite et repeat pour copier 
jusqu'au premier guillemet. (N'oubliez pas, un caractere n'est pas copie en memoire avant que 
vous n'utilisiez la touche fleche a droite pour faire passer le curseur de ce caractere sur le 
suivant). Votre affichage TV doit donner ceci: 

]LIST 10 

10 PRINT |THIS IS A PROGRAM" 

] 

Maintenant tapez un autre ESCAPE D pour deplacer-le curseur jusqu'a la ligne vide qui se 
trouve juste au-dessus de la ligne en cours et I'affichage va donner ce qui suit: 

]LIST 10 

I 

10 PRINT "THIS IS A PROGRAM" 

] 
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Tapez les caracteres a inserer, dans ce cas, TAB(10). Votre affichage TV va donner ce qui suit: 

]LIST 10 

TAB (10) ;| 
10 PRINT "THIS IS A PROGRAM" 

I 

Tapez un escape C pour abaisser le curseur d'une ligne de fagon que I'affichage donne ce qui 
suit: 

]LIST 10 

TAB (10) ; 
10 PRINT "THIS IS§A PROGRAM" 

] 

Maintenant revenez en arriere jusqu'au premier guillemet a I'aide de escape B (si vous utilisiez 
ici la touche fleche a gauche, vous effaceriez les caracteres que vous venez de taper). 
L'affichage TV va donner ce qui suit: 

]LIST 10 

TAB (10) ; 
10 PRINT |THIS IS A PROGRAM" 

] 

A partir d'ici, copiez le reste de la ligne a I'aide de la touche fleche a droite et repeat jusqu'a ce 
que I'affichage donne ce qui suit: 

]LIST 10 

TAB (10) ; 
10 PRINT "THIS IS A PROGRAM"| 

] 

Enfoncez la touche RETURN et tapez LIST pour obtenir ce qui suit: 

] LIST 

10 PRINT TAB (10) ; "THIS IS A PROGRAM" 
20 GOTO 10 

1 

Lorsque vous desirez eviter de copier des espaces blancs supplementaires que le format LIST 
introduit en cours de ligne (comme ceux qui se trouvent entre le R et le de PROGRAM, dans 
I'exemple ci-dessus), utilisez escape A. escape A deplace le curseur vers la droite sans copier 
les caracteres. Ceci peut etre particulierement utile pour recopier des instructions PRINT, 
INPUT et REM, ou APPLESOFT n'ignore pas les espaces blancs supplementaires. 

Souvenez-vous qu'en utilisant les touches escape on peut copier et editer un texte affiche a 
n'importe quel endroit de I'ecran TV. 
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APPENDIX C 



Messages d erreur 

Lorsqu'une erreur se produit, BASIC revient au niveau instruction comme indique parle 
caractere indicateur ] et un curseur clignotant. Les valeurs variables et le texte du programme 
demeurent intacts, mais le programme ne peut pas se poursuivre et tous les compteurs de 
boucle GOSUB et FOR se sont positionnes a zero. 

Pour eviter cette interruption dans un programme qui passe, on peut utiliser I'instruction ONERR 
GOTO, en liaison avec une routine de traitement d'erreur. 

Lorsqu'une erreur se produit dans une instruction a execution immediate, aucun numero de 
ligne n'est imprime. 

Format des messages d'erreur: 

Instruction a execution immediate ?XX ERROR. 
Instruction a execution differee ?XX ERROR IN YY. 

Dans les deux exemples ci-dessus 'XX' est le nom d'une erreur specifique; 'YY' est le numero 
de la ligne de I'instruction a execution differee ou I'erreur s'est produite. Des erreurs dans une 
instruction a execution differee ne sont pas detectees avant execution de cette instruction. 

Ci-dessous les codes des erreurs possibles et leur signification. 

CAN'T CONTINUE 

Essaie de poursuivre un programme alors qu'il n'y en a pas ou lorsqu'une erreur s'est produite 
ou lorsqu'une ligne a ete effacee du programme ou a ete ajoutee au programme. 

DIVISION BY ZERO 

La division par zero constitue une erreur. 

ILLEGAL DIRECT 

Vous ne pouvez pas utiliser une instruction INPUT, DEF FN, GET ou DATA comme instruction 
a execution immediate. 

ILLEGAL QUANTITY 

Le parametre affecte a une fonction mathematique ou a une fonction chaine etait hors de 
I'etendue. Des erreurs ILLEGAL QUANTITY peuvent se produire par suite de: 

a) un SUBSCRIPT (indice) de tableau negatif (par exemple LET A(-1)=0); 

b) utilisation de LOG avec un argument negatif ou nul; 

c) utilisation de SQR avec un argument negatif; 

d) A A B avec A negatif et B non entier; 

e) utilisation de MID$, LEFT$, RIGHTS, WAIT, PEEK, POKE, TAB, SPC, 
ON. ..GOTO ou de I'une quelconque des fonctions graphiques avec un argument 
incorrect. 
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NEXT WITHOUT FOR 



La variable dans une instruction NEXT ne correspond pas a la variable de I'instruction FOR 
encore en effet ou une instruction NEXT sans nom correspond a I'une ou I'autre des instructions 
FOR qui etait encore a I'effet. 

OUT OF DATA 

Une instruction READ etait en cours d'execution mais toutes les instructions DATA du 
programme avaient deja ete lues. Le programme essayait de lire trap de donnees ou bien il y 
avait insuffisamment de donnees dans le programme. 

OUT OF MEMORY 

L'une des causes suivantes peuvent causer cette erreur: programme trap important; trap de 
variables; des boucles FOR emboTtees a plus de 10 niveaux de profondeur; les instructions 
GOSUB emboTtees a plus de 24 niveaux de profondeur; une expression trap compliquee; des 
parentheses emboTtees a plus de 36 niveaux de profondeur; un essai de positionner LOMEM 
trap haut; un essai de positionner LOMEM en-dessous de la valeur actuelle; un essai de 
positionner LOMEM trap bas. 

FORMULA TOO COMPLEX 

Plus de deux instructions de la forme IF "XX" THEN ont ete executees. 

OVERFLOW 

Le resultat d'un calcul etait trap important pour etre represente dans le format de nombre du 
BASIC. Si, inversement, on a un nombre trap faible (tres proche de zero), c'est zero qui est 
donne comme resultat et I'execution du programme se poursuit sans qu'il apparaisse de 
message d'erreur. 

REDIM'D ARRAY 

Apres que Ton ait dimensionne un tableau, une autre instruction de dimension se rencontre pour 
le meme tableau. Cette erreur arrive souvent si un tableau a regu la dimension par defaut 10 du 
fait qu'une instruction comme A(l)=3 est suivie d'un programme par une instruction DIM A 
(1001 . Ce message d'erreur peut se prouver utile si vous souhaitez decouvrir sur quelle ligne de 
programme un certain tableau a ete dimensionne: il suffit d'inserer une instruction de dimension 
pour ce tableau a la premiere ligne, de faire passer le programme et APPLESOFT va vous dire 
ou se trouve I'instruction de dimension d'origine. 

RETURN WITHOUT GOSUB 

On a rencontre une instruction RETURN sans qu'une instruction correspondante GOSUB ne 
soit executee. 

STRING TOO LONG 

En utilisant un operateur de concatenation, on a essaye de creer une chaTne de plus de 255 
caracteres de longueur. 

BAD SUBSCRIPT 

On a essaye de se referer a un element de tableau qui se trouve en dehors des dimensions du 
tableau. Cette erreur peut se produire si on utilise un nombre errone de dimensions dans une 
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reference de tableau; par exemple si on utilise LET A (1,1,1)=Z alors que le tableau A a ete 
dimensionne a I'aide de DIM A(2,2). 

SYNTAX ERROR 

Oubli d'une parenthese dans une expression, caractere illegal dans une ligne, ponctuation 
incorrecte, etc. 

TYPE MISMATCH 

Le cote gauche d'une instruction d'affectation etait une variable numerique et le cote droit etait 
une chaTne ou vice versa; ou bien une fonction qui attendait un argument chaTne regoit un 
argument numerique ou vice versa. 

UNDEF'D STATEMENT 

On a essaye, par les instructions GOTO, GOSUB ou THEN, de renvoyer a un numero 
destruction qui n'existe pas. 

UNDEF'D FUNCTION 

On a fait reference a une fonction definie par I'utilisateur mais que I'utilisateur n'a pas defini. 
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APPENDICE D 

Economiseurs d'espace memoire 

Des conseils pour economiser Vespace memoire 

Pour que votre programme puisse s'adapter dans un espace de memoire plus petit, on peut 
suivre les conseils suivants. Toutefois les deux premiers conseils ne doivent etre pris en compte 
que si Ton se trouve en face de serieuses limitations concernant I'espace. Les programmeurs 
serieux donnent souvent deux versions de leur programme: une version etendue largement 
documentee (avec des REM) et I'autre reduite pour utiliser le minimum d'espace en memoire. 

1) Utilisez des instructions multiples par ligne. II n'y a qu'un petit en-tete (5 octets) associe a 
chaque ligne de programme. Deux de ces 5 octets contiennent le numero de ligne de la ligne en 
binaire. Ceci signifie que quel que soit le nombre de chiffres que vous avez dans votre numero 
de ligne (le numero de ligne minimum est 0, le maximum est 65529), il prend le meme nombre 
d'octets (deux). En plagant le plus destructions possible sur chaque ligne, vous reduisez le 
nombre d'octets utilises par votre programme (une seule ligne peut comprendre jusque 239 
caracteres). 

Note: le fait de combiner plusieurs instructions sur une ligne rend tres difficile les changements 
d'edition et autres changements. II rend egalement tres difficile la lecture et la comprehension 
d'un programme non seulement pour d'autres personnes mais meme pour vous si vous revenez 
plus tard a ce programme. 

2) Effacez toutes les instructions REM. Chaque instruction REM utilise au moins un octet plus le 
nombre d'octets du texte proprement dit. Par exemple I'instruction 

130 REM THIS IS A COMMENT 

utilise 24 octets de memoire. Dans I'instruction 

14 X=X+Y: REM UPDATE SUM 

le REM utilise 12 octets de memoire y compris les deux points avant le REM. 

Note: de meme que les programmes a lignes multiples, un programme sans instructions 
detaillees REM est tres difficile a lire et a comprendre non seulement pour les autres mais 
egalement pour vous si vous revenez plus tard a ce programme. 

3) Utilisez des tableaux d'entiers au lieu de tableaux de reels chaque fois que possible (voir 
I'information concernant I'affectation des memoires plus loin dans cet appendice). 

4) Utilisez des variables au lieu de constantes. Supposons que vous utilisiez la constante 
3.14159 dix fois dans votre programme. Si vous inserez une instruction 

10 P=3. 14159 

dans le programme et utilisez P au lieu de 3.14159 chaque qu'il est necessaire, vous 
economiserez 40 octets. Ceci se traduit egalement par une amelioration de la vitesse. 

5) Un programme n'a pas besoin de se terminer avec END; on peut done supprimer I'instruction 
END a la fin du programme. 

6) Reutilisez les memes variables. Si vous avez une variable T utilisee pour conserver un 
resultat provisoire dans une partie du programme et si vous avez besoin plus loin d'une variable 
provisoire dans votre programme, utilisez-la a nouveau. Ou si vous demandez a I'utilisateur de 
I'ordinateur de donner une reponse YES ou NO a deux questions differentes, a deux instants 
differents, pendant I'execution du programme, utilisez la meme variable provisoire A$ pour 
enregistrer la reponse 
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7) Utilisez des instructions GOSUB pour executer les sections des instructions de programme 
qui executent des actions identiques. 

8) Utilisez les elements zeros des matrices; par exemple A(01 , B(0,X) 

9) Si A$="CAT" est reassigne en A$="DOG", I'ancienne chaTne "CAT" n'est pas effacee de la 
memoire. En utilisant periodiquement une instruction de la forme 

X=FRE(0) 

dans votre programme, vous ferez en sorte que APPLESOFT "fasse le menage" pour enlever 
les anciennes chaTnes du haut de la memoire. 

Information concernant I'affectation des memoires 

Les variables simples (autres que des tableaux) reelles, entieres ou chaTnes comme V, V%, ou 
V$ utilisent 7 octets. Les variables reelles utilisent 2 octets pour le nom de la variable et 5 octets 
pour leur valeur (1 pour I'exposant et 4 pour la mantisse). Les variables entieres utilisent 2 
octets pour le nom de la variable, 2 octets pour sa valeur et ont des dans les 3 autres octets. 
Les variables chaTnes utilisent 2 octets pour le nom de la variable, 1 octet pour la longueur de la 
chaTne, 2 octets pour un pointeur a I'emplacement de la chaTne en memoire et ont des dans 
les deux autres octets. 

Les variables reelles en tableaux utilisent au minimum 12 octets: 2 octets pour le nom de la 
variable, 2 octets pour les valeurs d'indice, 1 octet pour le nombre de dimensions, 2 pour les 
valeurs d'indice de chaque dimension et 5 octets pour chaque element du tableau. Les variables 
entieres en tableau n'utilisent que 2 octets pour chaque element du tableau. Les variables 
chaTnes en tableau utilisent 3 octets pour chaque element du tableau: un pour la longueur, deux 
pour un pointeur. 

Les variables chaTnes, soit simples soit en tableaux, utilisent un octet de memoire pour chaque 
caractere de la chaTne. Les chaTnes elles-memes sont situees dans I'ordre de leur arrivee dans 
le programme en commengant a HIMEM:. 

Lorsqu'on definit une nouvelle fonction par une instruction DEF, on utilise 6 octets pour 
enregistrer en memoire le pointeur correspondant a la definition. 

Les mots reserves comme FOR, GOTO ou NOT et les noms de fonctions intrinseques comme 
COS, INT et STR $ ne prennent qu'un octet de memoire de programme. Tous les autres 
caracteres en programme utilisent un octet de memoire de programme chacun. 
Lorsqu'un programme est en cours d'execution, I'espace est attribue dynamiquement sur les 
piles comme suit: 

1) Chaque boucle active FOR . . . NEXT utilise 16 octets. 

2) Chaque instruction GOSUB active (e'est-a-dire qui n'a pas encore fait I'objet de 
I'instruction RETURN) utilise 6 octets. 

3) Chaque parenthese rencontree dans une expression utilise 4 octets et chaque 
resultat provisoire calcule dans une expression utilise 12 octets. 
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APPENDICE E 

Pour accelerer votre programme 

Les conseils ci-dessous doivent ameliorer le temps d'execution de vos programmes BASIC. 
Notez que certains de ces conseils sont les memes que ceux utilises pour diminuer I'espace 
utilise par vos programmes. Ceci signifie que dans de nombreux cas vous pouvez a la fois 
ameliorer la vitesse de vos programmes et ameliorer I'efficacite de I'utilisation de la memoire. 

1) Ceci est probablement le conseil le plus important, d'un facteur de 10, concernant la vitesse: 
utilisez des variables au lieu des constantes. II taut plus de temps pour convertir une constante 
en sa representation flottante (nombre reel) qu'il n'en faut pour prendre en charge la valeur 
d'une variable simple ou en tableau. Ceci est specialement important dans les boucles FOR . . . 
NEXT ou autres codes a executer de fagon repetitif. 

2) Les variables qui sont rencontrees les premieres pendant I'execution d'un programme BASIC 
sont affectees au debut du tableau de variable. Ceci signifie que I'instruction comme 

5A=0:B=A:C=A 

va placer A en premier, B en second et C en troisieme dans le tableau de variables (en 
supposant que la ligne 5 est la premiere instruction executee par le programme). Plus loin dans 
le programme, lorsque BASIC trouve une reference a la variable A, il ne cherche qu'une entree 
dans le tableau des variable pour trouver A, deux entrees pour trouver B et trois entrees pour 
trouver C, etc. . . . 

3) Utilisez les instructions NEXT sans variables indicees. NEXT est un peu plus rapide que 
NEXT I parce qu'il n'y a pas de verification a faire pour voir si la variable specifiee dans le NEXT 
est la meme que la variable qui se trouvait dans I'instruction FOR encore active la plus recente. 

4) Pendant I'execution du programme, lorsque APPLESOFT rencontre la reference a une 
nouvelle ligne comme "GOTO 1000", il explore la totalite du programme utilisateur en 
commengant par les lignes les plus basses jusqu'a ce qu'il trouve le numero de ligne reference 
(1000 dans cet exemple). II faut done placer les lignes a reference frequente aussitot que 
possible dans le programme. 
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APPENDICE F 

Signes decimaux pour les mots-cles 



decimal 


Mot-cle Signe decimal 


Mot-cle 


Signe decimal 


Mot-cle 


128 


END 


164 


LOMEM: 


200 


+ 


129 


FOR 


165 


ONERR 


201 


- 


130 


NEXT 


166 


RESUME 


202 




131 


DATA 


167 


RECALL 


203 


1 


132 


INPUT 


168 


STORE 


204 


A 


133 


DEL 


169 


SPEED= 


205 


AND 


134 


DIM 


170 


LET 


206 


OR 


135 


READ 


171 


GOTO 


207 


> 


136 


GR 


172 


RUN 


208 


= 


137 


TEXT 


173 


IF 


209 


< 


138 


PR# 


174 


RESTORE 


210 


SGN 


139 


IN# 


175 


& 


211 


INT 


140 


CALL 


176 


GOSUB 


212 


ABS 


141 


PLOT 


177 


RETURN 


213 


USR 


142 


HLIN 


178 


REM 


214 


FRE 


143 


VLIN 


179 


STOP 


215 


SCRN( 


144 


HGR2 


180 


ON 


216 


PDL 


145 


HGR 


181 


WATT 


217 


POS 


146 


HCOLOR = 


182 


LOAD 


218 


SQR 


147 


HP LOT 


183 


SAVE 


219 


RND 


148 


DRAW 


184 


DEF 


220 


LOG 


149 


DRAW 


185 


POKE 


221 


EXP 


150 


HTAB 


186 


PRINT 


222 


COS 


151 


HOME 


187 


CONT 


223 


SIN 


152 


ROT= 


188 


LIST 


224 


TAN 


153 


SCALE= 


189 


CLEAR 


225 


ATN 


154 


SHLOAD 


190 


GET 


226 


PEEK 


155 


TRACE 


191 


NEW 


227 


LEN 


156 


NOTRACE 


192 


TAB( 


228 


STR$ 


157 


NORMAL 


193 


TO 


229 


VAL 


158 


INVERSE 


194 


FN 


230 


ASC 


159 


FLASH 


195 


SPC( 


231 


CHR$ 


160 


COLOR= 


196 


THEN 


232 


LEFT$ 


161 


POP 


197 


AT 


233 


RIGHTS 


162 


VTAB 


198 


NOT 


234 


MID$ 


163 


HIMEM: 


199 


STEP 
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APPENDICE G 

Mots reserves dans APPLESOFT 



ABS 


AND 


ASC 


AT 


ATN 






CALL 


CHR $ 


CLEAR 


COLOR= 


CONT 


COS 




DATA 


DEF 


DEL 


DIM 


DRAW 






END 


EXP 












FLASH 


FN 


FOR 


FRE 








GET 


GOSUB 


GOTO 


GR 








HCOLOR= 


HGR 


HGR2 


HIMEM: 


HLIN 


HOME 


HP LOT 


IF 


IN# 


INPUT 


INT 


INVERSE 






LEFT$ 


LEN 


LET 


LIST 


LOAD 


LOG 


LOMEM 


MID$ 














NEW 


NEXT 


NORMAL 


NOT 


NOTRACE 






ON 


ONERR 


OR 










PDL 


PEEK 


PLOT 


POKE 


POP 


POS 


PRINT 


READ 


RECALL 


REM 


RESTORE 


RESUME 


RETURN 


RIGHTS 




RND 


ROT= 


RUN 








SAVE 


SCALE= 


SCRN( 


SGN 


SHLOAD 


SIN 


SPC( 




SPEED = 


SQR 


STEP 


STOP 


STORE 


STR$ 


TAB( 


TAN 


TEXT 


THEN 


TO 


TRACE 




USR 














VAL 


VLIN 


VTAB 










WAIT 














XPLOT 


DRAW 













PR# 



Le signe d'abreviation de et (&) est prevu uniquement pour usage interne de I'ordinateur; il n'est 
pas une instruction correcte APPLESOFT. Ce symbole, lorsqu'on I'execute comme instruction, 
amene un saut inconditionnel a remplacement $3F5. Utilisez reset Ctrl C pour reprendre le 
controle du programme. 
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XPLOT est un mot reserve qui ne correspond pas a une instruction APPLESOFT que dans un 
certain contexte. 




XPLOT est un mot reserve qui ne correspond pas a une instruction APPLESOFT en cours. 
COLOR, HCOLOR, SCALE, SPEED et ROT 

ne s'analysent comme mots reserves que si le caractere suivant autre qu'un espace est le signe 
de remplacement, =. Ceci ne presente que peu d'interet dans le cas de COLOR et HCOLOR, 
car le mot reserve inclus OR interdit leur usage de toute fagon dans des noms de variables. 

SCRN, SPC et TAB 

ne s'analysent comme mots reserves que si le caractere suivant qui ne soit pas un espace est 
une parenthese a gauche, ( . 

HIMEM: 

doit avoir le signe des deux points (:) pour s'analyser comme mot reserve. 
LOMEM: 

necessite egalement le signe des deux points (: 1 pour etre analyse comme mot reserve. 
ATN 

ne s'analyse comme mot reserve que s'il n'y a pas d'espace entre le T et le N. S'il y a un 
espace entre le T et le N, c'est le mot reserve AT qui est analyse au lieu de ATN. 

TO 

s'analyse comme mot reserve a moins qu'il ne soit precede d'un A et qu'il n'y ait un espace 
entre le T et le 0. S'il y a un espace entre le T et le O, c'est le mot reserve AT qui est analyse au 
lieu de TO. 

On peut parfois utiliser des parentheses pour tourner les mots reserves: 

100 FOR A = LOFT OR CAT TO 15 

donne le listage 

100 FOR A = LOF TO RC AT TO 15 

mais 

100 FOR A = (LOFT) OR (CAT) TO 15 

donne le listage 

100 FOR A = (LOFT) OR (C AT) TO 15 
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APPENDICE H 



Pour convertir les programmes BASIC en APPLESOFT 

Bien que les realisations de BASIC des differents ordinateurs soient en de nombreux points 
similaires, il existe certaines incompatibilites qu'il faut connaTtre si vous envisagez de convertir 
des programmes BASIC en APPLESOFT. 

1) Indices de tableau (de matrice). Certains BASIC utilisent "[" et "]" pour noter les indices de 
tableau. APPLESOFT utilise "(" et ")". 

2) ChaTnes. Un certain nombre de BASIC vous obligent a dimensionner (a declarer) la longueur 
des chaines avant les utiliser. Vous devez enlever toutes les instructions de dimension de ce 
type de votre programme. Dans certains de ces BASIC, une declaration de la forme DIM A$ (I, 
J) declare un tableau de chaines de J elements dont chacun a une longueur I. Convertissez les 
instructions DIM de ce type en leur equivalent en APPLESOFT: DIM A$(J). 

APPLESOFT utilise "+" pour la concatenation des chaines et non pas "," ou "&". 

BASIC utilise LEFT $, RIGHT $ et MID $ pour prendre les indices des chaines. D'autres BASIC 
utilisent A$(l) pour acceder au caractere d'ordre I des chaines A$ et A$(I,J) pour prendre une 
sous-chaine de la chaine A$ depuis la position de caractere I jusqu'a la position de caractere J. 

Convertissez comme suit: 

Ancien Nouveau 

A$(I) MID$(A$,I,1) 

A$(I,J) MID$(A$,I,J -I + 1 I 

Ceci suppose que la reference a une sous-chaine de la chaine A$ est dans une expression ou 
est cote droit de I'affectation. Si la reference A$ se trouve cote gauche de I'affectation et si X$ 
est I'expression chaine utilisee pour remplacer les caracteres dans A$ 

convertissez comme suit: 

Ancien Nouveau 

A$(I)=X$ A$=LEFT$ (A$, 1-1) +X$+MID$ (A$, 1+ 1) 

A$(I,J)=X$ A$=LEFT$ (A$, 1-1) +X$+MID$ (A$, J+ 1) 

3) Certains BASIC permettent des instructions "d'affectation multiple" de la forme: 

500 LET B=C=0 

Cette instruction devrait positionner les deux variables B et C a zero. 

Dans APPLESOFT, ceci a un effet entierement different. Tous les signes d'egalite qui se 
trouvent a la droite du premier doivent s'interpreter comme des operateurs de comparaison 
logique. Ceci positionnerait la variable B a - 1 si C est egal a 0. Si C n'est pas egal a 0, B serait 
positionne a 0. La fagon la plus simple de converser des instructions comme celle-ci est de la 
reecrire comme suit: 

500 C=0:B=C 
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4) Certains BASIC utilisent "/" au lieu de ":" pour delimiter des instructions multiples par ligne. 
Changez chaque "/" en ":" dans le programme. 

5) Les programmes qui utilisent les fonctions MAT dans certains BASIC devront etre reecrits en 
utilisant les boucles FOR . . . NEXT pour effectuer les operations appropriees. 
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Carte de la memoire 



Etendue de memoire Description 

0.1 FF Espace de travail du programme; non disponible pour I'utilisateur. 

200. 2FF Memoire tampon de caracteres de clavier. 

300. 3FF Disponible pour I'utilisateur pour de courts programmes en langage 

machine 

400. 7FF Zone d'affichage sur ecran pour le texte ou les graphiques couleurs page 

1. 

800.2FFF Dans la version cassette, zone de I'interpreteur APPLESOFT BASIC. 

800.XXX Si la carte APPLESOFT est mise en place (numero de piece A2B0009X) 

espace reserve au programme et aux variables de I'utilisateur, ou XXX 
est le maximum de memoires RAM a utiliser par APPLESOFT. C'est soit 
la totalite de la memoire RAM du systeme soit moins si I'utilisateur 
reserve une partie de la memoire superieure pour les routines de 
langage machine des memoires tampon de I'ecran haute resolution. 

2000. 3FFF Microprogrammation APPLESOFT seulement: affichage graphique haute 

resolution page 1 . 

3000. XXX APPLESOFT II sur cassette; reserve au programme et aux variables 

utilisateurs ou XXX est le maximum de memoires RAM disponible a 
utiliser par APPLESOFT. C'est soit la totalite de memoires RAM du 
systeme soit moins si I'utilisateur reserve une partie de la memoire 
superieure pour des routines de langage machine ou pour le graphique 
haute resolution page 2. 

4000. 5FFF Affichage graphique haute resolution page 2. 

C000.CFFF Adresses d'entree/sortie du materiel peripherique. 

D000.DFFF Futur extension de la memoire ROM. 

D000.F7FF Version APPLESOFT II sur carte avec selecteur position ON (en haut). 

E000.F7FF Integer BASIC APPLE. 

F800.FFFF Moniteur de systeme APPLE. 
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Diagramme de la carte de memoire de programme 
APPLESOFT 



Version cassette 



$3001 
$2FFF 

$801 



Pointeur 



Systeme d'exploitation de dis 

nette (si Ton utilise la 
disquette) 



Version microprogrammation 



($73 - $74 (HIMEM:) 
HIMEM:est automatiquement 

positionne pour avoir 
I'emplacement maximum de 

memoire RAM dans le 
systeme a moins qu'elle ne 
soit positionnee par 

I'utilisateur. 
ChaTnes $6F - $70 



Espace libre comprenant les 
memoires tampon pour ecran 
graphique haute resolution 
(avec APPLESOFT sur 
cassette seulement, la page 2 

est disponible). NOTE: 
I'espace pour les chaTnes peut 
remplir de donnees anciennes 

et venir deborder sur les 
ecrans haute resolution ou les 
programmes machines. Pour 
faire le menage et eviter ce 
probleme, inserez X=FRE(0) 
dans votre programme. 



$6D - $6E 
tableaux numeriques et 
tableaux de pointeurs de 
chaTnes (voir page 1371. 
$6B - $6C 



s Variables simples (voir page 
1371. 
$69 - $6A (LOMEM:) 



$AF - $B0 
PROGRAMME 
$67 - $68 



APPLESOFT 



$801 
F7FF 

D000 
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PEEK, POKE, CALL 

Voici quelques caracteristiques speciales de APPLESOFT que vous pouvez utiliser au moyen 
des instructions PEEK, POKE et CALL. Notez que certaines viennent doubler les effets d'autres 
instructions de APPLESOFT. 

Les actions de simple commutation dependent habituellement d'une adresse: n'importe quelle 
instruction impliquant cette adresse aura le meme effet sur la commutation. Ainsi done 
I'exemple peut etre 

POKE - 16304,0 

mais vous obtiendrez le meme effet en assignant a cette adresse, par I'instruction POKE, tout 
nombre de a 255 ou en regardant cette adresse par I'instruction PEEK 
X= PEEK (-16304) 

Ceci ne s'applique pas aux instructions ou vous devez assigner a I'adresse specifiee une valeur 
specifique qui positionne une marge ou deplace le curseur pour I'amener a une place 
specifique. 

Pour positionner la fenetre de texte 

Les quatre premieres instructions POKE, avec les numeros de ligne par exemple 10, 20, 30 et 
40 sont utilisees pour positionner la taille de la fenetre par laquelle vous voyez et vous deroulez 
le texte sur votre ecran TV. Ces instructions positionnent respectivement la marge de gauche, la 
largeur de la ligne, la marge du haut et la marge du bas de la fenetre. 

Le fait de positionner la fenetre de texte n'efface pas le reste de l'ecran et ne deplace pas le 
curseur dans la fenetre de texte (il faut utiliser pour cela HOME, ou HTAB et VTAB). 
L'instruction VTAB ignore completement la fenetre de texte: le texte imprime au-dessus de la 
fenetre apparaTt normalement tandis que le texte imprime en dessous de la fenetre apparaTt sur 
toute la ligne. HTAB peut egalement deplacer le curseur a I'exterieur de la fenetre mais 
seulement assez loin pour y imprimer un caractere. 

Une modification de la largeur de la ligne prend effet immediatement mais une modification de 
la marge de gauche n'est pas detectee avant que le curseur tente de revenir a la marge de 
gauche. 




Le texte qui apparaTt sur votre ecran TV n'est qu'une representation d'une portion particuliere de 
la memoire APPLE (page 1 du texte). L'ecran TV regarde toujours le texte qui se trouve dans la 
meme portion de la memoire et voit ce que APPLE y a ecrit. Si vous modifiez la fenetre de 
texte, cela revient a dire a APPLE ou il doit ecrire son texte en memoire. Ceci marche bien aussi 
longtemps que vous specifiez une portion de memoire quine trouve a i'interieur de la zone 
habituelle de texte. Mais si vous positionnez la marge de gauche disons a 255 (le maximum 
devra etre 40 puisque l'ecran a 40 positions de caractere en largeur), cela revient a dire a 
APPLE d'ecrire le texte bien au-dela de la zone de memoires habituelle reservee pour le texte. 
Cette memoire n'est pas vue sur l'ecran et peut contenir des parties de votre programme ou 
meme des informations necessaires pour APPLESOFT lui-meme. Pour sauvegarder votre 
programme et APPLESOFT, il faut se garder de positionner la fenetre sur le texte au-dela des 
limites de l'ecran de 40 caracteres par 24 lignes. 
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10 POKE 32, L 

Positionne la marge de gauche de I'affichage TV a la valeur specifiee par L, sur I'etendue allant 
de O a 39, ou est la position la plus a gauche. Cette modification ne s'effectue pas avant que 
le curseur n'arrive a un retour a la marge de gauche (retour de chariot). 




Cette instruction ne modifie pas I a largeur de la fenetre: ceci signifie que la marge de droite va 
se deplacer de la meme valeur que celle dont vous depassez la marge de gauche. Pour 
sauvegarder votre programme et APPLESOFT, il faut d'abord reduire la largeur de la fenetre de 
fagon appropriee puis modifier la marge de gauche. 

20 POKE 33, W 

Positionne la largeur (nombre de caracteres par ligne) de I'affichage TV a la valeur specifiee par 
W, sur I'etendue allant de 1 a 40. 




Ne positionnez pas W a zero: POKE 33, detruit APPLESOFT. 




Si W est inferieur a 33, un PRINT au troisieme champ de tabulateur peut imprimer des 
caracteres en dehors de la fenetre. 

30 POKE 34, T 

Positionne la marge de I'affichage TV a la valeur specifiee par T sur I'etendue allant de a 23 
ou est la ligne superieure de l'ecran. Une instruction POKE 34,4 permet de ne pas imprimer le 
texte sur les quatre premieres lignes de l'ecran. Ne positionnez pas la marge superieure de la 
fenetre (T) en-dessous de la marge inferieure (B) ci-dessous. 

40 POKE 35, B 

Positionne la mare inferieure de I'affichage TV a la valeur specifiee par B, sur I'etendue allant de 
a 24, ou 24 est la ligne inferieure de l'ecran. Ne positionnez pas la marge inferieure de la 
fenetre (B) au-dessus de la marge superieure (T, ci-dessus). 

Autres instructions affectant le texte, la fenetre de texte et 
le clavier 

45 CALL -936 

Efface tous les caracteres qui se trouvent a I'interieur de la fenetre de texte et deplace le 
curseur pour I'amener a la position d'impression superieure gauche de la fenetre. C'est la meme 
instruction que esc @ return (Escape @) et que I'instruction HOME. 
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50 CALL -958 



Efface tous les caracteres qui se trouvent a I'interieur de la fenetre de texte depuis la position 
actuelle du curseur jusqu'a la marge inferieure. Les caracteres qui se trouvent au-dessus du 
curseur et les caracteres qui se trouvent a gauche du curseur dans sa ligne d'impression ne 
sont pas affectes. Cette instruction est la meme 
esc F (Escape F). 

Si le curseur se trouve au-dessus de la fenetre de texte, cette instruction efface depuis le 
curseur jusqu'aux marges de droite, de gauche et en bas comme si la marge superieure etait 
au-dessus du curseur. II n'est pas habituellement pas souhaitable d'utiliser cette instruction si le 
curseur se trouve en-dessous de la marge inferieure de la fenetre de texte: habituellement la 
ligne inferieure de la fenetre de texte est effacee ainsi qu'une ligne de la largeur de la fenetre de 
texte et la position du curseur. 

60 CALL -868 

Efface la ligne en cours depuis le curseur jusqu'a la marge de droite. Cette instruction est la 
meme que esc E (Escape E). 

70 CALL -922 

Declenche un saut de ligne. C'est la meme instruction que Ctrl J (control J). 
80 CALL -912 

Deroule une ligne de texte, c'est-a-dire deplace chaque ligne de texte vers le haut d'une position 
a I'interieur de la fenetre definie. L'ancienne ligne superieure est perdue: la ligne qui etait 
auparavant la seconde devient la premiere; la ligne inferieure devient vierge. Les caracteres qui 
se trouvent a I'exterieur de la fenetre definie ne sont pas affectes. 

90 X= PEEK(-16384) 

Lit le clavier. Si X> 127, on a enfonce une touche et X est la valeur ASCII de la touche enfoncee 
avec le bit 7 positionne (a un). Cette instruction est utile pour des longs programmes ou 
I'ordinateur verifie pour voir si I'utilisateur desire interrompre avec de nouvelles donnees sans 
arreter I'execution du programme. 

100 POKE -163680 

Repositionne le signal de selection du clavier de fagon que le caractere suivant puisse etre lu; 
ceci doit se faire immediatement apres avoir lu le clavier. 

Instructions qui sont en rapport avec le curseur 

110 CH = PEEK(36) 

Lit la position horizontale actuelle de curseur et donne la variable CH egale a cette position. CH 
va etre sur I'etendue a 39 et est la position du curseur par rapport a la marge de gauche et la 
fenetre de texte comme on I'a defi ni par POKE 32, L. Par consequent si la marge de gauche a 
ete defini POKE 32,5 alors le caractere le plus a gauche qui se trouve dans la fenetre se trouve 
a la sixieme position d'impression a partir du bord gauche de I'ecran et si PEEK (36) fournit une 
valeur de 5 c'est que le curseur etait a la onzieme position d'impression a partir du bord gauche 
de I'ecran et done a la sixieme position d'impression a partir de la marge de gauche de la 
fenetre de texte (cela ne parait pas clair tout d'abord, parce que la position la plus a gauche est 
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la position zero et non pas la position 1 1 . Cette instruction est identique a la fonction POS (X). 
(Voir exemple suivant). 

120 POKE 36,CH 

Deplace le curseur pour I'amener a une position qui est la position d'impression d'ordre CH + 1 
a partir de la marge de gauche de la fenetre de texte. (Exemple: POKE 36,0 va faire que le 
caractere suivant sera imprime a la marge gauche de la fenetre). Si la marge de gauche de la 
fenetre a ete definie a 6 (POKE 32,6) et si vous desirez mettre un caractere a trois positions a 
partir du bord gauche de I'ecran, il faut d'abord modifier la marge gauche de la fenetre avant 
d'executer I'instruction PRINT. CH doit etre inferieur ou egal a la largeur de la fenetre definie par 
POKE 22, W et doit etre superieur ou egal a zero. Comme HTAB cette instruction peut deplacer 
le curseur audela de la marge de droite de la fenetre de texte mais seulement assez loin pour 
permettre d'imprimer un caractere. 
130CV = PEEK(37) 

Lit la position verticale actuelle du curseur et fournit une valeur CV egale a cette position. CV 
est la position verticale absolue du curseur et ne se rapporte pas aux marges superieures ou 
inferieures de la fenetre de texte. Done CV=0 est la ligne superieure de I'ecran et CV=23 en est 
la ligne inferieure. 

140 POKE 37,CV 

Deplace le curseur pour I'amener a la position verticale absolue specifiee par CV. est la ligne 
superieure de I'ecran et 23 est la ligne inferieure. 



Instructions affectant les graphiques 

Dans le but de I'affichage du texte et des graphiques, la memoire de APPLE est divisee en 
quatre zones: les pages 1 et 2 du texte et les pages 1 et 2 haute resolution. 

1) La page 1 de texte est la zone de memoire habituelle pour tout le texte et pour les 
graphiques basse resolution utilisee par les instructions TEXT et GR. 

2) La page 2 reside juste au-dessus de la page de texte 1 en memoire. Elle n'est pas 
facilement lisible a I'utilisateur. Comme pour la page 1 de texte, I'information 
enregistree sur la page 2 de texte peut s'interpreter soit comme texte soit comme 
graphique basse resolution ou les deux. 

3) La page 1 graphique haute resolution reside dans la memoire de APPLE entre 8 K et 
16 K. C'est la zone utilisee par I'instruction HGR. Si un texte est affiche avec cette 
page, ce texte provient de la page de texte 1 . 

4) La page 2 graphique haute resolution reside dans la memoire de APPLE entre 16 K 
et 24 K. C'est la zone utilisee par I'instruction HGR2. Si du texte est affiche avec cette 
page, ce texte provient de la page 2 de texte. 

Pour utiliser les differents modes graphiques et texte, vous pouvez utiliser des instructions texte 
et graphique de APPLESOFT ou vous pouvez manoeuvrer ces quatre selecteurs differents. 
Comme pour beaucoup des selecteurs discutes ici, une instruction PEEK ou POKE a une 
adresse place le selecteur d'une fagon et la meme instruction ou POKE a une deuxieme 
adresse place le selecteur d'une autre fagon. 
En bref, ces quatre selecteurs permettent de choisir entre 

1) Affichage texte (POKE -16303,0) 

2) Page 1 du texte ou haute resolution (POKE -16300,0) 
et page 2 du texte ou haute resolution (POKE -1 6299,0) 

3) Page 1 ou 2 du texte pour les graphiques (POKE -16298,0) 
et page 1 ou 2 haute resolution pour les graphiques (POKE -16297,0) 

4) Graphique haute ou basse resolution sur la totalite de I'ecran (POKE -16302,0) 
et mode mixte graphique haute ou basse resolution + texte (POKE -16301 ,0) 
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150 POKE -16304,0 



Cette instruction fait commuter le mode d'affichage pour passer du texte au graphique couleur 
sans effacer I'ecran graphique pour le rendre noir. Selon les positions des trois autres 
selecteurs, le mode graphique sur lequel on est ainsi passe peut etre basse ou haute resolution, 
en provenant de la page 1 ou et peut etre en mode mixte graphique + texte ou graphique sur la 
totalite de I'ecran. 

Instructions APPLESOFT semblables: I'instruction GR fait passer sur page 1 basse resolution, 
mode mixte graphique + texte et efface I'ecran graphique pour le rendre noir. L'instruction HGR 
fait passer sur page 1 haute resolution, mode mixte graphique + texte et efface I'ecran 
graphique pour le rendre noir. L'instruction HGR2 fait passer sur page 2 haute resolution, 
graphique sur la totalite de I'ecran et efface la totalite de I'ecran pour le rendre noir. 

160 POKE -16303,0 

Commute le mode d'affichage pour passer d'un affichage graphique couleur quelconque au 
mode entierement texte sans ramener a I'origine le defilement de la fenetre. Selon la position du 
selecteur page 1 /page 2, la page de texte sur laquelle on est commute peut etre soit la page 1 
soit la page 2 de texte. 

L'instruction TEXT fait passer en mode entierement texte, mais en plus choisit la page 1 de 
texte, ramene au maximum a I'origine le defilement de la fenetre et positionne le curseur dans 
Tangle inferieur gauche de I'ecran TV. 

170 POKE -16302,0 

Commute pour passer du mode mixte graphique + texte au mode graphique sur la totalite de 
I'ecran. Selon les positions de autres selecteurs peut donner un texte, un graphique basse 
resolution sur la trame 40 par 48 ou un graphique haute resolution sur la trame 278 par 192. 

180 POKE -16304,0 

Commute pour passer du mode graphique sur la totalite de I'ecran au mode mixte graphique + 
texte, avec quatre lignes de 40 caracteres de texte en bas de I'ecran. 

Selon les positions des autres selecteurs, la portion superieure de I'ecran peut montrer du texte, 
du graphique basse resolution sur trame de 40 par 40 ou du graphique haute resolution sur 
trame de 278 par 160. Les deux portions de I'affichage sur I'ecran vont provenir de la page du 
meme numero (1 ou 2). 

184 POKE -16300,0 

Commute pour passer de la page 2 a la page 1 sans effacer I'ecran ni deplacer le curseur. Cette 
instruction est necessaire pour passer en Integer BASIC en venant de APPLESOFT; a defaut, 
vous pourriez encore regarder a la page 2 de la memoire. 

Selon les positions des autres secteurs, cette instruction peut faire passer I'affichage depuis 
graphique haute resolution page 2 pour devenir graphique haute resolution page 1, depuis 
graphique basse resolution page 2 pour devenir graphique basse resolution page 1 ou depuis 
page de texte page 2 pour devenir page de texte page 1 . 

186 POKE -16299,0 

Commute pour passer de page 1 a page 2 sans effacer I'ecran ni deplacer le curseur. 
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Selon les positions des autres selecteurs, cette instruction peut modifier I'affichage depuis 
graphique haute resolution page 1 pour devenir graphique haute resolution page 2, depuis 
graphique basse resolution page 1 pour devenir graphique basse resolution page 2, ou depuis 
page de texte 1 pour devenir page de texte 2. 

190 POKE -16298,0 

Commute la page pour graphique pour passer de la page graphique haute resolution a la meme 
page de texte, sans effacer I'ecran. Cette instruction est necessaire lorsque vous passez en 
Integer BASIC en venant de APPLESOFT; a defaut, I'instruction Integer BASIC GR peut vous 
montrer incorrectement la page haute resolution. 

Selon les positions des autres selecteurs, cette instructions peut modifier I'affichage depuis 
graphique haute resolution page 1 pour devenir graphique basse resolution page 1, depuis 
graphique haute resolution page 2 pour devenir graphique basse resolution page 2 ou (en mode 
texte) peut ne pas modifier I'affichage. 

195 POKE -16297,0 

Commute la page pour graphique depuis une page de texte pour devenir la page 
correspondante haute resolution, sans effacer I'ecran. 

Selon les positions des autres selecteurs, cette instruction peut modifier I'affichage depuis 
graphique basse resolution page 1 pour devenir graphiques haute resolution page 1, depuis 
graphique basse resolution page 2 pour devenir graphique haute resolution page 2 ou (en mode 
texte) peut ne pas modifier I'affichage. 

200 CALL -1994 

Efface les 20 lignes superieures de la page texte 1 pour donner les signes inverses @.. Si vous 
etes en mode page 1 graphique basse resolution, cette instruction efface 40 lignes superieures 
de I'ecran graphique pour le rendre noir. Elle n'a pas d'effet sur la page texte 2 ou sur le 
graphique haute resolution. 

205 CALL -1998 

Efface la totalite de la page texte 1 pour la donner en signes inverses @. Si vous etes en mode 
graphique basse resolution page 1 sur la totalite de I'ecran, cette instruction efface la totalite de 
I'ecran pour le rendre noir. Elle n'a pas d'effet sur la page texte 2 ou sur le graphique haute 
resolution. 

200 CALL -62450 

Efface I'ecran haute resolution en cours (APPLESOFT se souvient de I'ecran que vous avez 
utilise en dernier lieu, independamment des positions des selecteurs) pour le rendre noir. 

210 CALL -62454 

Efface I'ecran haute resolution en cours (APPLESOFT se souvient de I'ecran que vous avez 
utilise en dernier lieu, independamment des positions des selecteurs) pour la donner dans la 
couleur correspondant a l'instruction HCOLOR utilisee la plus recemment dans un trace. Elle 
doit etre precede d'un trace. 
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Instructions en rapport avec les commandes de jeu et les 
haut-parleur 



220 X= PEEK (-16336) 

Bascule une fois I'interrupteur du haut-parleur: produit un "click" en provenance du haut parleur. 
225 X= PEEK (-16352) 

Bascule une fois I'interrupteur de sortie cassette: produit un "click" en provenance du lecteur de 
cassette. 

230 X= PEEK (-16287) 

Lit la position du contact a bouton-poussoir de la commande de jeu #0. Si X> 127 c'est que ce 
bouton-poussoir est enfonce. 

240 X= PEEK (-16286) 
Comme-ci dessus mais pour le bouton-poussoir de la commande de jeu # 1 . 

250 X= PEEK (-16285) 
Comme-ci dessus mais pour le bouton-poussoir de la commande de jeu #2. 

260 POKE -16296,1 

Met la sortie #0 de I'annonciateur de commande de ,eu (connecteur de jeu I/O broche 15) au 
niveau TTL collecteur ouvert haut (3,5 V). C'est la condition off /hors circuit. 

270 POKE -16295,0 

Met la sortie #0 de commande de jeu au niveau TLL bas (0,3 V). C'est la condition on/en circuit : 
intensite maxima 1,6 milliamperes. 

280 POKE -16294,1 

Met la sortie de commande de jeu # 1 (connecteur de jeu I/O broche 14) au niveau TTL haut 
(3,5 V). 

290 POKE -16293,0 
Met la sortie de commande de jeu # 1 au niveau TTL bas (0,3 V1 . 

300 POKE -16292,1 

Met la sortie de commande de jeu #2 (connecteur de jeu I/O broche 13) au niveau TTL haut 
(3,5 V1. 

310 POKE -16291,0 
Met la sortie de commande de jeu #2 au niveau TTL bas (0,3 V). 

320 POKE -16290,1 

Met la sortie de commande de jeu #3 (connecteur de jeu I/O broche 12) au niveau TTL haut 
(3,5 V). 

330 POKE -16289,0 
Met la sortie de commande de jeu au niveau TTL bas (0,3 V1 . 
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Instructions relatives aux erreurs 



340 X = PEEK (218) + PEEK (219) * 256 
Cette instruction fournit X egal au numero de ligne de I'instruction ou il s'est produit une erreur si 
une instruction ONERRGOTO a ete executee. 

350 IF PEEK (216) > 127 THEN GOTO 2000 
Si le bit 7 a I'emplacement de memoire 222 (ERRFLG) a ete positionne correctement, une 
instruction ONERRGOTO a ete rencontree. 

360 POKE 216,0 - 

Efface ERRFLG de sorte que les messages normaux d'erreur sont ceux produits. 
370 Y = PEEK (222) 

Donne la variable Y selon un code qui decrit le type d'erreur qui etait a I'origine de la 
survenance d'un debranchement ONERRGOTO. Les types d'erreur sont decrits ci-dessous: 



Valeur Y 


Type d'erreur rencontre 





NEXT sans FOR 


16 


Syntaxe 


22 


RETURN sans GOSUB 


42 


En dehors des donnees/DATA 


53 


Quantite illegale 


69 


Deplacement 


77 


En dehors de la memoire 


90 


Instruction non definie 


107 


Mauvais indice 


120 


Tableau redimensionne 


133 


Division par zero 


163 


Erreur de frappe 


176 


ChaTne trap longue - 


191 


Formule trap complete 


224 


Fonction non definie 


254 


Mauvais reponse a une instruction INPUT 


255 


Tentative de Ctrl C Interrupt 



380 POKE 768, 104 : POKE 769,168 : POKE 770,104 : POKE 771,166 : POKE 772, 223 : 
POKE 773, 154 : POKE 774, 72 : POKE 775, 152 : POKE 776, 72 : POKE 777, 96 

Etablit un sous-programme en langage machine a I'emplacement 768, qui peut s'utiliser dans 
une routine de traitement des erreurs. Dissipe certains des problemes ONERR/GOTO avec 
I'instruction PRINT et les messages ?OUT OF MEMORY ERROR. Utilisez I'instruction CALL 
768 dans la routine de traitement des erreurs. 
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Carte des variables APPLESOFT 

Variables simples 



POINTEURS 
$69-$6A 



Variable reelle 



NOM (pos) 1 er octet 
(pos) 2e octet 



exposant 1 octet 
mantisse octet de poids fort 
mantisse 
mantisse 

mantisse octet de poids faible 



Variables entieres 



NOM(neg) 1er octet 
(neg) 2e octet 



octet fort 
octet faible 



Variable reelle 



Pointeurs de chaine 



NOM 


(neg) 


ler octet 




(pos) 


2e octet 


longuer 






adresse 




octet faible 


adresse 




octet fort 

















Variable reelle 



Variables entieres 



Pointeurs de chaine 



$6B - $6C 


NOM (pos) 


ler octet 




(pos) 


2e octet 



Decalage du pointeur pour arriver! 
a la variable suivante: a ajouter a } 
I adresse de ce nom de variable. ! 

octet faible 
octet fort 



Nombre dimensions 
1 octet 



Nombre d'elements de la 
dimension d'ordre N octet fort 
octet faible 



Nombre d'elements de la 
dimension d'ordre 1 octet fort 
octet faible 



Variable reele (0,0 0) 

exposant 1 octet 
mantisse octet de poids fort 
mantisse 
mantisse 

mantisse octet de poids faible 



Variable reelle (N,N N) 

exposant 1 octet 
mantisse octet de poids fort 
mantisse 
mantisse 

mantisse octet de poids faible 



NOMInegi 1er octet 
(negl 2e octet 



Decalage du pointeur pour arriver 
a la variable suivante: a ajouter a 
I'adresse de ce nom de variable. 

octet faible 
octet fort 



Nombre dimensions 
1 octet 



Nombre d'elements de la 
dimension d'ordre N octet fort 
octet faible 



J 



Nombre d'elements de la 
dimension d'ordre 1 octet fort 
octet faible 



Variable entiere (0,) 0) 

octet fort 
octet faible 



Variable entiere (N,N N) 

octet fort 
octet faible 



NOM (neg) 1er octet 
(pos) 2e octet 



Decalage du pointeur pour arriver 
a la variable suivante: £ ajouter a 
I'adresse de ce nom de variable. 

octet faible 
octet fort 



Nombre dimensions 
1 octet 



Nombre d'elements de la 
dimension d'ordre N octet fort 
octet faible 



Nombre d'elements de la 
dimension d'ordre 1 octet fort 
octet faible 



Chaines (0,0 0) 

longueur 1 octet 
adresse octet fort 
adresse octet faible 



Chaines (N,N N) 

longueur 1 octet 
adresse octet faible 
adresse octet fort. 



Les chaines sont memorisees dans leur ordre d'entree, a partir de HIMEM et en allant vers le 
bas. Le tableau de chaine a son pointeur correspondant au premier caractere de chaque 
chaine, a la base de la chaine en memoire. Lorsque les chaines sont modifiees, de nouvelles 
adresses de pointage sont ecrites. Lorsque la memoire disponible est entierement utilisee, un 
nettoyage efface toutes les chaines abandonnees (le nettoyage est declenche par une 
instruction FRE (X). 

Tous les tableaux sont enregistres en memoire avec I'indice le plus a droite progressant le plus 
lentement; par exemple, on trouve dans I'ordre suivant les nombres qui se trouvent dans le 
tableau A%11,11 ou A%(0,0)=0, A%1 1,01=1, A%10,11=2, A%11,11=3. 
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APPENDICE K 

Codes de caractere ASCII 

DEC = code decimal ASCII 
HEX = code hexadecimal ASCII 
CHAR = nom du caractere ASCII 

n/a = non accessible directement a partir du clavier APPLE II. 



DEC 


HEX 


CHAR 


Ce qu'il faut taper 


DEC 


HEX 


CHAR 


Ce qu'il faut 





00 


NULL 


Ctrl @ 


32 


20 


SPACE 


barre espace 


1 


01 


SOH 


Ctrl A 


33 


21 


! 


! 


2 


02 


STX 


Ctrl B 


34 


22 






3 


03 


ETX 


Ctrl C 


35 


23 


# 


# 


4 


04 


ET 


Ctrl D 


36 


24 


$ 


$ 


5 


05 


ENQ 


Ctrl E 


37 


25 


% 


% 


6 


06 


ACK 


Ctrl F 


38 


26 


& 


& 


7 


07 


BEL 


Ctrl G 


39 


27 






8 


08 


BS 


Ctrl H ou <- 


40 


28 


( 


( 


9 


09 


HT 


Ctrl I 


41 


29 


) 


) 


10 


OA 


LF 


Ctrl J 


42 


2A 






1 1 


OB 


VT 


Ctrl K 


43 


2B 


+ 


+ 


12 


OC 


FF 


Ctrl L 


44 


2C 


■ 


■ 


13 


0D 


CR 


■ ill i—\ 1 r- 1 1 i— \ fc 1 

Ctrl M ou RETURN 


45 


2D 


~ 


~ 


14 


0E 


SO 


Ctrl N 


46 


2E 






15 


OF 


SI 


Ctrl 


47 


2F 


/ 


/ 


16 


10 


DLE 


Ctrl P 


48 


30 








17 


1 1 


DC1 


Ctrl 


49 


31 


1 


1 


18 


12 


DC2 


Ctrl R 


50 


32 


2 


2 


19 


13 


DC3 


Ctrl S 


51 


33 


3 


3 


20 


14 


DC4 


ctrIT 


52 


34 


4 


4 


21 


15 


NAK 


Ctrl ou -» 


53 


35 


5 


5 


22 


16 


SYN 


Ctrl V 


54 


36 


6 


6 


23 


17 


ETB 


Ctrl W 


55 


37 


7 


7 


34 


18 


CAN 


ctrIX 


56 


38 


8 


8 


35 


19 


EM 


Ctrl Y 


57 


39 


9 


9 


26 


1A 


SUB 


ctrIZ 


58 


3A 






27 


1B 


ESCAPE ESC 


59 


3B 






28 


1C 


FS 


n/a 


60 


3C 


< 


< 


29 


1D 


GS 


Ctrl shift-M 


61 


3D 






30 


1E 


RS 


Ctrl A 


62 


3E 


> 


> 


31 


1F 


US 


n/a 


63 


3F 


? 


? 
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DEC 


HEX 


CHAR 


Ce qu'il f; 


64 


40 


@ 


@ 


65 


41 


A 


A 


66 


42 


B 


B 


67 


43 


C 


C 


68 


44 


D 


D 


69 


45 


E 


E 


70 


46 


F 


F 


71 


47 


G 


G 


72 


48 


H 


H 


73 


49 


I 


I 


74 


4A 


J 


J 


75 


4B 


K 


K 


76 


4C 


L 


L 


77 


4D 


M 


M 


78 


4E 


N 


N 


79 


4F 








80 


50 


P 


P 


81 


51 


Q 


Q 


82 


52 


R 


R 


83 


53 


S 


S 


84 


54 


T 


T 


85 


55 


U 


U 


86 


56 


V 


V 


87 


57 


w 


w 


88 


58 


X 


X 


89 


59 


Y 


Y 


90 


5A 


z 


z 


91 


58 


[ 


n/a 


92 


5C 


\ 


n/a 


93 


5D 


] 


] (shift-M) 


94 


5 E 


A 


A 


95 


5F 




n/a 



Les codes ASCII sur I'etendue 96 a 255 vont engendrer des caracteres sur APPLE qui repetent 
ceux de la liste ci-dessus (d'abord ceux de la colonne 2, puis toute la seriel. Bien que CHR 
$165) donne un A et que CHR$(193) donne egalement un A, APPLE II ne reconnaTt pas les 
deux comme etant le meme caractere lors de leur utilisation comme operateurs logiques de 
chaine et une imprimante reliee a votre ordinateur APPLE les imprimera differemment. 
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APPENDICE L 

Utilisation de la page zero de la memoire APPLESOFT 

EMPLACEMENT UTILISATION 

(en hexadecimal) 

$0 - $5 Instructions de branchement a poursuivre dans APPLESOFT (reset 0G 

return pour APPLESOFT equivalent a reset Ctrl C return pour Integer 
BASIC). 

$A - $C Emplacement pour instruction de branchement de la fonction USR voir 

description de la fonction USR. 

$D - $1 7 Compteurs/flags d'usage general pour APPLESOFT. 

$20 - $4F Emplacements reserves au moniteur de systeme APPLE II. 

$50 - $61 Pointeurs d'usage general pour APPLESOFT. 

$62 - $66 Resultat de la multiplication /division effectuee en dernier lieu. 

$61 - $68 Pointeur indiquant le debut du programme. Normalement positionne a 

$0801 pour la version ROM ou $3001 pour la version RAM (bande 
cassette). 

$69 - $6A Pointeur indiquant le debut de I'emplacement reserve aux variables 

simples. Indique egalement la fin du programme plus 1 ou 2, sauf 
modification demandee par I'instruction LOMEM. - 

$6B - $6C Pointeur indiquant le debut de I'emplacement reserve aux tableaux. 

$6D - $6 E Pointeur indiquant la fin de I'emplacement reserve a un enregistrement 

des valeurs numeriques en cours. 

$6F - $70 Pointeur indiquant le debut de I'emplacement reserve a I'enregistrement 

des chaines. Les chaTnes sont enregistrees a partir d'ici jusqu'a la fin de 
la memoire. 

$71 - $72 Pointeur general. 

$73 - $74 Emplacement le plus eleve en memoire disponible pour APPLESOFT 

plus un. Lors de I'entree initiale en APPLESOFT, cet emplacement est 
positionne a I'emplacement le plus eleve disponible de memoire RAM. 

$75 - $76 Numero de la ligne en cours d'execution. 

$77 - $78 Numero de I'ancienne ligne. Mis en place par une instruction Ctrl C, 

STOP ou END. Donne le numero de la ligne ou I'execution a ete 
interrompue. 
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EMPLACEMENT UTILISATION 

(en hexadecimal) 



$79- 


$7A 


Pointeur de I'ancien texte. Indique 1'emplacement en memoire pour la 

nrr\r*h^inQ motri mtin.i""i n nvnni itnr 

procnaine instruction a executer. 


$7B- 


-$7C 


Numero de la ligne en cours ou on lit actuellement les donnees. 


<t7n 




I^i^in"! ifl 1 'omi^l nn m n nt n t"\ r* n 1 1 1 n k~» n rvi n i rn ni 1 n lit Iqc /H n k*» ki nn 
IllUICjUy 1 cIlipidGfcJIIlfcJIll dUSUlU fcrll 1 llcl IlUlltJ UU Oil ML Icb (JUilllccb. 


<C"7E 


IpoU 


Indique la source actuelle des donnees d'entree. Positionne a $201 
pendant une instruction INPUT. Pendant une instruction READ est 
position nee sur les donnees lues dans le programme. 


$0 i ■ 




Dn.tin.nt 1 n. rt n Ho 1 o \/o ri o l^ln i 1 1 i 1 i o n n nn rJoj'riiAi' lini i 

rifcJUtJill It? llUlll Uc Id VdlldUlfc; UllllbccJ oil UclMIci llfcrll. 


$00 - 




1 n.n! in; i i n 1 o wnl ni i r /-In 1 o wn. ri n n.|n i itilif Aa n n HoKi^ior Mam 

inaique la vaieur ue la vanaDie utinsee en aernier neu. 


$00 ■ 




usage general. 


(tan 


- tpAo 


Accumulateur principal a virgule flottante. 






UbaLJc LJcilcidl Udllb lob pi ULJI dl 1 II I lcb 1 1 IdU IfcM 1 IdULjUob d Vliyuifc; IIULldilLc. 


<£ A^ 


- CpMD 


A nn i imi i IntAi ik nnn n n! o t r r\ o wirn:i iln. flnttontn. 

Mccuinuiaieur seconaaire a virguie Tiottante. 


$AC 


- $AE 


Flags/pointeurs d'usage general. 


$AF 


-BO 


Indique la fin du programme (non modifiee par LOMEM: 1 . 


$B1 • 


-$C8 


Routine CHRGET. APPLESOFT appelle ici chaque fois qu'il desire un 
autre caractere. 


tpbo 


CtDQ 


Indique le dernier caractere obtenu au moyen de la routine CHRGET. 


;t>oy 


<tr*n 


Nombre aleatoire. 




- $uo 


Pointeurs d'effacement des graphiques haute resolution. 


IpDo 


- cpDr 


Pointeurs ONERR /effacement. 




- 3>C£ 


nn rr\ Ann Arte Y nt \/ Qn n n hi i n 1 1 in hoi itn n 1 1 1 1 i n n 

^ooraonnees a et t en grapnique naute resolution. 






Octet de couleur graphique haute resolution. 






1 lenn a n: n. n n k o 1 nni ir nrorihini in hni it a pn. c* n 1 i itinn 

usage general pour grapnique naute resolution. 


<£Fn 




1 n *H i n i in In nlohl it /Hi I tnhlnni i r\ n. fnrm n 

inaique le aeuui au tauieau ae Torrne. 


$EA 




Compteur de collisions pour graphique haute resolution. 


$F0- 


$F3 


Signaleurs d'usage general. 


$F4-$F8 


Pointeurs ONERR. 
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APPENDICE M 



Differences entre APPLESOFT et Integer BASIC 



Differences entre les instructions 

Les instructions suivantes existent dans APPLESOFT mais non: en Integer BASIC. 



ATN 






CHR$ 


COS 




DATA 


DEF FN 


DRAW 


EXP 






FLASH 


FN 


FRE 


GET 






HCOLOR 


HGR 


HGR2 


INT 


INVERSE 




LEFT$ 


LOG 


LOMEM: 


MID$ 






NORMAL 






ON GO 




ON...GOTC 


SUB 






POS 






READ 


RECALL 


RESTORE 


SCALE 


SHLOAD 


SIN 




STORE 


STR$ 


TAN 






USR 






VAL 






WAIT 






XDRAW 







HIMEM: 



HOME 



HP LOT 



ONERR GOTO 



RESUME 
SPC 



RIGHTS 
SPEED 



ROT 
SQR 



STOP 



Les instructions suivantes existent dans Integer BASIC mais non dans: APPLESOFT 

AUTO 

DSP 

MAN MOD 



Les instructions suivantes ont des noms differents dans les deux langages: 



Integer BASIC 

CLR 
CON 
TAB 

GOTOX* 10+100 

GOSUB X* 100+ 1000 

CALL-936 

POKE 50,127 

POKE 50,255 

X 

# 



APPLESOFT 

CLEAR 
CONT 

HTAB (note: APPLESOFT a aussi une instruction TAB) 

ON X GOTO 100, 110, 120 

ON X GOSUB 1 000, 1 1 00, 1 200 

HOME (ou CALL -936) 

INVERSE 

NORMAL 

X% (% indique une variable entiere) 
oorx 
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Autre differences 



En Integer BASIC on verifie si la syntaxe d'une instruction est correcte lorsque cette instruction 
est enregistree dans la memoire de I'ordinateur (lorsque vous enfoncez la touche RETURN. 
Dans APPLESOFT, cette verification s'effectue lorsque I'instruction est executee. 

Dans APPLESOFT, GOTO et GOSUB doivent etre suivis d'un numero de ligne; Integer BASIC 
met une variable ou une expression arithmetique. 

Les variables et les constantes reelles (nombres a virgule flottante avec virgule decimale et/ou 
exposant) sont autorises dans APPLESOFT mais non dans Integer BASIC. 

Dans APPLESOFT, seuls les deux premiers caracteres d'un nom de variable sont significatifs 
(par exemple APPLESOFT reconnait comme etant la meme variable les noms GOOD et 
GOUGE. Dans Integer BASIC tous les caracteres d'un nom de variable sont significatifs. 
Les operations sur les chaTnes se definissent differemment dans les deux langages. Les 
chaTnes et les tableaux doivent etre I'un et I'autre dimensionnes en Integer BASIC; en 
APPLESOFT, seuls les tableaux doivent etre dimensionnes. 

En APPLESOFT les tableaux peuvent etre multidimensionnels; en Integer BASIC, les tableaux 
sont limites a une seule dimension. 

APPLESOFT positionne tous les elements d'un tableau a zero en executant RUN, CLEAR, ou 
RESET. En Inter BASIC le programme utilisateur doit positionner tous les elements du tableau a 
zero. 

En Integer BASIC, si la condition posee dans I'instruction IF . . . THEN . . . ne se realise pas, 
seule la portion THEN de cette instruction est ignoree. En APPLESOFT, toutes les instructions 
qui suivent un THEN et se trouvent sur la meme ligne sont ignorees si la condition posee par 
I'instruction IF . . . THEN . . . ne se realise pas; I'execution du programme saute a la ligne de 
programme de numero suivant. 

Dans APPLESOFT, I'instruction TRACE affiche le numero de ligne de chaque instruction 
individuelle se trouvant sur une ligne de programme a instruction multiple, et non pas 
simplement la premiere instruction comme en Integer BASIC. 

Dans APPLESOFT, les instructions CALL, PEEK et POKE peuvent utiliser la total ite de 
I'etendue des adresses d'emplacement de memoire (de a 65535) En Integer BASIC, il faut se 
referer aux emplacements a adresse superieur a 32767 par leur valeur negative 
complementaire (a I'emplacement 32768 s'appelle -32767 -1 ; I'emplacement 32769 s'appelle - 
32767; I'emplacement 32770 s'appelle -32766; etc.). 

END dans un programme qui s'arrete sur le numero de ligne le plus eleve est optionnel dans 
APPLESOFT mais necessaire dans tous les cas pour eviter un message d'erreur dans Integer 
BASIC. 

NEXT doit etre suivi d'un nom de variable dans Integer BASIC; un nom de variable est optionnel 
dans APPLESOFT. 

En Integer BASIC la syntaxe de I'instruction INPUT est 
INPUT [string,]{varj 

Si var est une avar, alors INPUT imprime un ? avec ou sans la chaine optionnelle. Si var est 
une avar, alors il n'y a pas de ? imprime, qu'il y ait ou non une chaTne optionnelle. En 
APPLESOFT, la syntaxe de I'instruction INPUT est INPUT [string;] {ar} 

Si la chaTne optionnelle est omise, APPLESOFT imprime un ?; si la chaTne optionnelle est 
presente, il n'y a pas de ? imprime. 
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APPENDICE N 

Glossaire alphabetiques des definitions syntaxiques et des 
abreviations 

Voir le chapitre 2 pour une presentation logique (par opposition a alphabetique) de ces 
definitions. Le symbole := signifie "est au moins partiellement defini comme". 

Caractere alphanumerique 
:= lettre/chiffre - 

alop 

:= operateur logique arithmetique 

:= AND IORI=l>l<lxlol<=l=<l>=l=> 

C'est volontaire que NOT n'est pas compris ici. 

aop 

:= operateur arithmetique 

avar 

:= variable arithmetique ' 
:= nom I nom%. 

Toutes les variables simples occupent 7 octets en memoire, 2 octets pour le nom et 

5 octets pour la valeur reelle ou entiere. 
:= indice avar - 

Dans les tableaux, les nombres reels occupent 5 octets, les nombres entiers 2 
octets. 

aexpr 

:= expression arithmetique - 
:= avar I reel I entier 
:= indice avar 
:= (aexpr) 

Si les parentheses sont emboTtees sur plus de 36 niveaux de profondeur, on 

obtient le message ? OUT OF MEMORY ERROR 
:= [+ I - 1 NOT] aexpr. 

Un NOT unaire apparaTt ici, en meme temps qu'un + et un - unaire. 
:= aexpr slop aexpr 
:= sexpr op sexpr 

caractere 

:= lettre I chiffre I special 

Ctrl 

:= maintenir enfoncee la touche marquee "CTRL" tout en enfongant la touche dont 
le nom suit. 

def 

:= mode-execution differee. 
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delimiteur 

:=~I(I)H-NTI<I>|/U;l: 

Un nom n'a pas a etre separe d'un mot reserve qu'il precede ou qu'il suit par I'un de 
ces delimiteurs. 



chiffre 



expr 



:= 1|2|3|4|5|6|7|8|9|0 

:= enfoncer la touche marquee "ESC" 



:= expression 
:= aexpr | sexpr 



:= mode-execution immediate 



entier 

:= [+ |-] {digit} Les entiers doivent etre entre -32767 et 32767. 

Pour convertir des nombres non entiers en entiers on peut habituellement 
considerer que APPLESOFT tronque le non-entier pour obtenir I'entier inferieur 
le plus proche. Toute fois, ce n'est pas tout a fait vrai dans la mesure ou le non- 
entier s'approche de rentier superieur le plus proche. Par exemple: 

A% = 1 23.999 999 959 999 B% = 1 23.999 999 96 

PRINT A% PRINT B% 

123 124 

C% = 1 2345.999 995 999 D% = 1 2345.999 996 

PRINT C% PRINT D% 

12345 12346 

(Les lignes blanches ont ete ajoutees pour faciliter la lecture). Un entier element 
d'un tableau occupe 2 octets (16 bits) en memoire. 

nom d'une variable entiere 
:= nom % 

Une variable reelle peut etre enregistree sous forme de variable entiere, mais 
APPLE SOFT convertit d'abord la variable reelle en une variable entiere. 



lettre 
ligne 
linenum 



:=A|B|C|D|E|F|G|H|l|J|K|L|M|N|0|P|Q|R|S|T|U|V|W|X|Y|Z 
:= linenum [ { instruction: } ] instruction return. 



:= numero de ligne 
:= chiffre [{chiffre}] 

Les numeros de ligne doivent aller de a 63999 sinon il en resulte un message 
d'erreur ? SYNTAX ERROR 



expression litterale 

. = [{caractere}] 



GUIDE PRATIQUE DU BASIC ETENDU 133 



lettre minuscule 

:= a|b|c|d|e|f|g|h|i|j|k|l|m|n|o|p|q|r|s|t|u|v|w|x|y|z 



metanom 

:= {metasymbole} [chiffre] 
metasymbole 

:= caracteres utilises dans ce document pour indiquer qu'ils sont en structures ou 
relations dans APPLESOFT, mais qui ne font pas partie du langage lui-meme. 



:= lettre minuscule 

:= un chiffre unique concatene a un metanom 



nom 



nom% 



nom $ 



: = lettre [ { lettre / chiffre } ] 

Un nom peut avoir une longueur allant jusque 238 caracteres. Lorsqu'il faut 
distinguer un nom d'un autre, APPLESOFT ignore tout caractere 
alphanumerique situe apres les deux premiers. APPLESOFT ne distingue done 
pas entre les noms GOOD, 4 LITTLE et GOLDRUSH. Toutefois meme la partie 
ignoree d'un nom ne doit pas contenir un special ou un des mots reserves de 
APPLESOFT. 



:= nom d'une variable reelle. 

:= nom d'une variable entiere. 

:= nom d'une variable chaTne. chaine nulle 



op 

:= operateur 
:= aop | alopl 

caractere souffleur 

: = ] Le crochet a droite (]) est affiche lorsque APPLESOFT est pret a accepter une 
instruction. 

nombre reel 

:=[ + !-] {chiffre} [ {chiffre} ] [ E + | - ]chiffre[chiffre] ] 
:=[ + !-] [{chiffre}].[{chiffre}] [E f+ I - ]chiffre [chiffre] ] 

La lettre E, utilisee dans la notation du nombre reel (une forme de "notation 
scientifique') signifie "exposant". C'est I'abreviation de 10 A . Dix est eleve a la 
puissance du nombre qui se trouve a la droite de E et le nombre qui se trouve a 
la gauche de E est multiplies par le resultat. 

En APPLESOFT les nombres reels doivent aller de -1E38 a 1E38, sinon vous 
risquez le message ? OVERFLOW ERROR 

En utilisant I'addition et la soustraction il est possible que vous obteniez des 
nombres de I'importance de 1 .7E38 sans recevoir ce message. Un nombre reel 
dont la valeur absolue est inferieure a environ 2.9388E-39 sera converti par 
APPLESOFT en zero. 
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APPLESOFT reconnait les nombres suivants comme des nombres reels lorsqu'ils 
se presenters par eux-memes et les evalue pour zero. 



+. -. .E +.E -.E 

.E .E- +.E- +.E+ -.E+ -.E- 

Par consequent I'element de tableau M (.) est le meme que M (01. En plus des 
nombres reels abreges de la liste ci-dessus, les suivants sont reconnus comme 
nombre reels et evalues pour zero lorsqu'ils sont utilises comme reponse 
numerique a une instruction INPUT ou comme elements numeriques de 
I'instruction DATA. 

+ - E +E -E espace 
E+ E- +E+ +E- -E+ -E- 

L'instruction GET evalue tous les nombres reels a simple caractere des listes ci- 
dessus. 

Lorsqu'on imprime un nombre reel, APPLESOFT indiquera au plus 9 chiffres (voir 
les sections ci-dessous) non compris I'exposant (s'il y en a un). Tous les chiffres 
qui viennent a la suite sont arrondis. A la gauche du point decimal, tous les zeros 
qui precedent le chiffre le plus a gauche qui ne soit pas un zero ne soient pas 
imprimes. A la droite du point decimal, tous les zeros qui suivent le chiffre le plus 
a droite qui ne soient pas un zero ne soient pas imprimes. S'il n'y a pas a droite 
du point decimal de chiffres qui ne soient pas des zeros, le point decimal de 
chiffres qui ne soient pas des zeros, le point decimal n'est pas imprime. 

m 

Le resultat de I'arrondi peut etre curieux. 

PRINT 99 999 999.9 



PRINT 99 999 999.90 

100 000 000 

PRINT 11.111 111 451 9 
11.111 111 4 

PRINT 11.111 111450 00 
11.111 111 5 

(Les espaces blancs sont ajoutes pour faciliter la lecture). 

Si la valeur absolue d'un nombre reel est superieur ou egal a 01 et inferieur 999 
999 999.2, le nombre reel est imprime en notation a point decimal fixe. C'est a 
dire que I'exposant n'est pas affiche. Sur I'etendue .0 100 000 000 5 a .0 999 
899 999, les nombres reels sont imprimes avec dix chiffres maximum, y compris 
le zero qui se trouve immediatement a la droite du point decimal. C'est la seule 
exception a la limite de 9 chiffres imprimes non compris I'exposant. 

Si vous essayez d'utiliser un nombre de plus de 38 chiffres comme 
211.1111111111111111111111111111111111 
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alors le message 

? OVERFLOW ERROR 

s'imprime, meme si ce nombre se trouve certainement entre -1 E38 et 1 E38. 

Ceci est vrai meme si la plus grande partie des chiffres sont des zeros de queue, 

comme dans 
21 1 .00000000000000000 00000000000000000 

Les zeros de tete toutefois sont ignores. Le premier chiffre est un un et si le second 
chiffre est inferieur ou egal a six, des nombres contenant 39 chiffres peuvent 
s'utiliser sans donner lieu a message d'erreur. 

Un nombre reel occupe 5 octets (40 bits en memoire). 



nom de variable reelle 
:= nom 



mot reserve 



reset 



return 



■■ certains groupes de caracteres utilises par APPLESOFT pour specifier dans 
instructions ou des portions d'instructions. Un nom ne doit pas comprendre un 
mot reserve. Se reporter a I'appendice G en ce qui concerne une liste des mots 
reserves de APPLESOFT. 



: enfoncer la touche marquee "RESET". 



: enfoncer la touche marquee "RETURN" 



sexpr 



■■ expression 1 chaTne 
■■ svar chaTne 
■■ sexpr sop sexpr 



slop 



■■ operateur logique chaTne 

: =|>|>=|=><|<=|=<k>|>< 



sop 



■■ operateur chaTne 

: + 



special 



:= symbole special utilise par APPLESOFT II 
:=I|#|$|%|&|T1(I)I*|/| A I<I>I=I+|-|:|;I,I-I@I?I] 

Les caracteres de controle (caracteres qui sont tapes tout en maintenant enfoncee 
la touche CTRL et le caractere nul sont egalement des caracteres speciaux. On 
peut taper le crochet a droite h) sur le clavier APPLE mais APPLESOFT ne 
I'utilise que comme caractere indicateur. Dans ce document, il est utilise comme 
metasymbole. 



indice 



:= (aexpr [{,aexpr}] 

Le nombre maximum de dimensions (aexpr) est 89, bien qu'en pratique soit limite 
par la taille de la memoire disponible. aexpr doit etre positif et, pour I'utiliser, est 
converti en un entier. 
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chaine 

:= [{caractere}] Une chaine occupe 2 octets (16 bites) en memoire pour son 
pointeur d'emplacement, plus un octet (8 bits) pour chaque caractere de la 
chaine. 

:= [{ caractere }] return 

Cette forme de chaine ne peut apparaitre qu'a la fin d'une ligne. 



nom d'une variable chaine 
:= nom$ 



svar 

:= variable chaine 

:= name$ name$ indice Le pointeur d'emplacement et le nom de la variable 
occupent chacun 2 octets en memoi re. La longueur et chaque caractere de la 
chaine occupent 1 octet. 



var 



:= variable 
:= avar | svar 



:= metasymbole utilise pour separer des alternatives 

(note: un item peut egalement se definir separement pour chaque alternative) 



■ metasymbole utilises pour isoler un element optionnel 



:= metasymbole utilises pour isoler un element qui peut se repeter 
:= metasymbole utilises pour isoler un element dont il faut utiliser la valeur : la 
valeur de x s'ecrit x. 



:= metasymbole qui indique un espace necessaire. 
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APPENDICE O 

Resume des instructions APPLESOFT 

La derniere page de ce manuel contient un index alphabetique qui vous renvoie aux 
descriptions plus detaillees des instructions APPLESOFT contenues dans les chapitres 3 a 10. 

ABS (-3.451) 

donne la valeur absolue de I'argument. L'exemple donne 3.451 . 
Touches a fleche 

Les touches reperees d'une fleche a droite ou a gauche sont utilisees pour editer les 
programmes APPLESOFT. La touche fleche a droite deplace le curseur vers la droite. Au fur et 
a mesure qu'il le fait, chaque caractere sur lequel il passe sur I'ecran est entre vers la gauche; 
chaque fois qu'il se deplace, un caractere est efface dans la ligne de programme que vous etes 
en train de taper, quel que soit le caractere sur lequel le curseur se deplace. 

ASC ("QUEST") 

donne le code decimal ASCII correspondant au premier caractere de I'argument. Dans cet 
exemple, donne 81 (correspondant a Q dans ASCII). 

ATN (2) 

donne Tare tangente, en radians, de I'argument. Dans cet exemple, on obtiendra 1.10714872 
(radians). 

CALL -922 

amene I'execution de sous-programme en langage-machine qui se trouve a I'emplacement 
memoire dont I'adresse decimale est specifiee. L'exemple va amener un saut de ligne. 

CHR $ (65) 

donne le caractere ASCII qui correspond a la valeur de I'argument, qui doit etre et 255. 
L'exemple donne la lettre A. 

CLEAR 

Positionne toutes les variables a zero et toutes les chaines a une valeur nulle. 



COLOR = 12 

definit la couleur pour le trace en mode graphique basse-resolution. Dans l'exemple la couleur 
definie est le vert. La couleur est annulee par I'instruction GR. Les noms des couleurs et leur 
nombres associes sont 

noir 8 brun 

1 magenta 9 orange 

2 bleu fonce 1 gris 

3 pourpre 1 1 rose 

4 vert fonce 1 2 vert 

5 gris 13jaune 

6 bleu moyen 14 aqua/turquoise clair 

7 bleu clair 15blanc 

Pour connaitre la couleur d'un point donne de I'ecran, utilisez I'instruction SCRN. 



CONT 

si I'execution du programme a ete arretee par STOP, END Ctrl C ou reset 0G, I'instruction CONT 
fait que I'execution reprend a I'instruction suivante (comme avec GOSUB) et non au numero de 
ligne suivant. 
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Rien n'est efface. Apres reset OG return, le programme ne peut pas continuer correctement car 
certains pointeurs et supports du programme sont effaces. L'instruction CONT ne peut pas 
s'utiliser si vous avez 

a) modifie, ajoute ou efface une ligne du programme ou 

b) b) regu un message d'erreur depuis I'arret de I'execution 

COS (2) 

donne le cosinus de I'argument, qui doit etre en radians. Dans I'exemple on obtient -.415146836 
Ctrl C 

peut s'utiliser pour interrompre un programme en train de passer ou un listage. Peut egalement 
s'utiliser pour interrompre une instruction INPUT mais seulement si c'est le premier caractere 
entre. L'instruction INPUT n'est pas interrompue avant que la touche RETURN ne soit 
enfoncee. 

ctrlX 

demande a APPLE II d'ignorer la ligne actuellement en cours de frappe, sans effacertoute ligne 
precedente de meme numero de ligne. Une barre oblique inverse ( \ 1 est affichee a la fin de la 
ligne a ignorer. 

DATA JOHN SMITH, "CODE 32", 23.45, -6 
cree une liste d'elements que Ton peut utiliser au moyen des instructions READ. Dans I'exemple 
le premier element est I'expression litterale JOHN SMITH; le deuxieme element est la chaine 
"CODE 32"; le troisieme element est le nombre reel 23.45; le quatrieme element est rentier -6. 

DEF FN A(W)=2*W+W 

Permet a I'utilisateur de definir dans un programme des fonctions de une ligne. II faut tout 
d'abord definir la fonction a I'aide de DEF; puis par la suite dans le programme on peut utiliser la 
fonction precedemment definie a I'aide de l'instruction DEF. L'exemple illustre comment definir 
une fonction FN A(W); elle peut s'utiliser par la suite dans le programme sous la forme FN A 
(23) ou FNA (-7*0+ 1) et ainsi de suite. FN A123) va faire que W soit remplace par READ dans 
2*W+W; la fonction sera alors evaluee a 2*23+23 ou 69. Supposons = 2; alors FN AI7*Q+ 1) 
est equivalent a FN AI-7*2+ 1 ) ou FN AI-1 31 : la fonction sera evaluee pour 2*(-1 3)+(-1 3) ou -26- 
13 ou 39. 

DEL 23,56 

enleve I'etendue specifiee de lignes dans le programme. Dans I'exemple les lignes 23 a 56 
seront effacees dans le programme. Pour effacer une seule ligne, disons la ligne 350, utilisez la 
forme DEL 350,350 ou tapez simplement le numero de ligne puis enfoncez la touche RETURN. 

DIM AGE (20,3), NAMES (50) 
Lorsqu'une instruction s'execute, elle reserve la place du tableau specifie, avec des indices DIM 
de a I'indice indique. Dans I'exemple a NAMES 150) seront reservees 50 + 1 ou 51 chaTnes 
de longueur quelconque; au tableau AGE (20,3) seront reserves (20+ 1)*(3+ 1) ou 21 *4 ou 84 
elements nombres reels. Si un element de tableau est utilise dans le programme avant d'avoir 
ete dimensionne, un indice de valeur maxima 10 est reserve pour chaque dimension dans les 
indices de I'element. Les elements du tableau sont positionnes a zero en executant RUN ou 
CLEAR. 

DRAW 4 AT 50, 100 

dessine une forme dont le numero de definition est 4 a partir d'un tableau de forme 
precedemment charge, en graphique haute-resolution, en partant de x = 50, y = 100. La 
couleur, la rotation et I'echelle de la forme a dessiner doivent avoir ete specifiees avant 
execution de l'instruction DRAW. 

END 
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amene un programme a cesser son execution et rend le controle a I'utilisateur. Aucun message 
n'est imprime. 

esc A ou esc B ou esc C ou esc D 
la touche peut s'utiliser en liaison avec les touches des lettres A. B ou C ou D pour deplacer le 
curseur sans affecter les caracteres sur lesquels passe le curseur. Pour deplacer le curseur 
d'un espace, enfoncez d'abord la touche Escape puis relachez cette touche et enfoncez la 
touche de la lettre appropriee. 



Commande Deplace le curseur d'un espace 

esc A vers la droite 

esc B vers la gauche 

esc C vers le bas 

esc D vers le haut 



EXP (2) 

donne la valeur "e" de elevee a la puissance* indiquee par I'argument. Avec 6 decimales, 
e=2.718289, et dans cet exemple on aura 7.3890561 

FLASH 

regie le mode video en clignotement, le signal emis par I'ordinateur apparaissant 
alternativement sur I'ecran TV en caracteres blancs sur fond noir puis inversement en 
caracteres noirs sur fond blanc. Utilisez l'instruction NORMAL pour revenir a un affichage non 
clignotant en lettres blanches sur fond noir. 

FOR W= 1 TO 20 . . . NEXT W 

FOR 0=2 TO -3 STEP -2... NEXT Q 

FOR Z=5 TO 4 STEP 3 . . . NEXT Z 
vous permet d'ecrire une boucle pour effectuer un nombre specifie de fois les instructions 
quelconques qui se trouvent entre l'instruction FOR (la tete de la boucle) et l'instruction NEXT 
(la base de la boucle) Dans le premier exemple la variable W compte combien de fois il faut 
executer les instructions; les instructions qui se trouvent a I'interieur de la boucle seront 
executees pour W egale a 1 , 2, 3 ... 20, puis la boucle s'arrete (avec W=21) et c'est l'instruction 
qui se trouve apres NEXT W, qui s'execute. Le second exemple illustre comment indiquer le pas 
(STEP) si vous voulez qu'il soit different de 1 . La verification se place a la fin de la boucle; par 
consequent dans le troisieme exemple les instructions qui se trouvent a I'interieur de la boucle 
ne seront executees qu'une seule fois. 

FRE (0) 

fournit la valeur de la memoire, en octets, dont dispose encore I'utilisateur. Ce que vous mettez 
a I'interieur des parentheses n'a pas d'importance dans la mesure ou il peut etre evalue par 
APPLESOFT. 

GET ANS $ 

amene un caractere unique du clavier sans le montrer sur I'ecran TV et sans qu'il soit besoin 
d'enfoncer la touche RETURN. Dans I'exemple le caractere tape au clavier est enregistre dans 
la variable ANS $. 

GOSUB 250 

amene le programme a se brancher sur la ligne indiquee (250 par exemple). Lorsque Ton 
execute une instruction RETURN le programme se branche sur l'instruction qui suit 
immediatement la plus recente instruction GOSUB executee. 

GOTO 250 

amene le programme a se brancher sur la ligne indiquee (250 dans I'exemple). 
GR 
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commute en mode graphique basse-resolution (40 X 40) pour l'ecran TV, en laissant 4 lignes de 
texte en bas du graphique. L'ecran est efface, devient noir, le curseur est amene dans la fenetre 
de texte et la couleur est reglee a (noir). 

HCOLOR = 4 

positionne la couleur du graphique haute resolution a la couleur specifiee par HCOLOR. Les 
noms de couleur et leurs valeurs associees sont: 
noir 

1vert (selon votre TV) 

2 bleu (selon votre TV) 

3 blanc 1 

4 noir 2 

5 (selon votre TV) 

6 (selon votre TV) 

7 blanc 2 

HGR 

n'existe que dans la version sur carte de APPLESOFT. Positionne le mode graphique haute- 
resolution (281 X 160) pour l'ecran en laissant 4 lignes pour le texte en bas de l'ecran. L'ecran 
est efface pour passer au noir et la page 1 de la memoire est affichee. L'execution de HGR 
n'affecte ni I'instruction HCOLOR ni la memoire de la partie de l'ecran reservee au texte. Le 
curseur n'est pas deplace dans la fenetre de texte. 

HGR 2 

positionne le mode graphique haute resolution sur la totalite de l'ecran (281 X 1921 . L'ecran est 
efface pour revenir au noir et la page 2 de la memoire est affichee. La memoire de l'ecran 
correspondant au texte n'est pas affectee. 

HIMEM: 16384 

positionne I'adresse de I'emplacement en memoire le plus eleve disponible pour un programme 
APPLESOFT, y compris les variables. S'utilise pour proteger les zones de memoire pour les 
donnees, les graphiques haute resolution ou les routines de langage machine. HIMEM n'est pas 
remis a I'etat initial par CLEAR, RUN, NEW, DEL par le fait de modifier ou d'ajouter une ligne de 
programme ou par reset. 

HLIN 10, 20, AT 30 

utilise pour tirer des droites horizontales en mode graphique basse resolution en utilisant la 
couleur la plus recemment specifiee par COLOR. L'origine (x = et y = O) du systeme est le 
point superieur le plus a gauche de l'ecran. Dans I'exemple on tire la droite allant de x 10 a x = 
20 pour y = 30. Autre fagon de s'exprimer: on tire la droite allant du point (10, 30) au point (20, 
301. 

HOME 

amene le curseur dans la position et a gauche de l'ecran dans la fenetre de texte et efface tout 
le texte qui se trouve dans la fenetre. 

HPLOT 10,20 
HPLOT 3, 40 TO 50, 60 
HPLOT TO 70, 80 

trace des points et des droites en mode graphique haute resolution en utilisant la valeur de 
HCOLOR la plus recemment specifie. L'origine est le point superieur le plus a gauche de l'ecran 
(x = 0, y = 01 . Le premier exemple trace un point haute resolution a x = 10, y = 20. Le second 
exemple trace une droite haute resolution allant du point x = 30, y = 40 au point x = 50,y = 60. 
Le troisieme exemple trace une droite partant de ce dernier point trace et allant au point x = 70, 
y = 80, en utilisant la couleur du dernier point trace et non pas necessairement la plus recente 
instruction HCOLOR. 
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HTAB 23 

deplace le curseur soit vers la gauche, soit vers la droite pour venir dans la colonne specifiee (1 
a 40) sur l'ecran. Dans I'exemple le curseur sera positionne dans la colonne 23. 

IF AGE< 18 THEN A=0: B= 1: C=2 
IF ANS $ "YES" THEN GOTO 100 
IF N<MAX THEN 25 
IF N<MAX GOTO 25 

Si I'expression qui suit IF s'evalue comme vraie (i.e. non zero), alors la ou les instructions qui 
suivent THEN sur la meme ligne seront executees. Sinon toutes les instructions qui suivent 
THEN sont ignorees et l'execution passe a I'instruction de la ligne de numeros suivants du 
programme. Les expressions chaTnes sont evaluees par ordre alphabetique. Les exemples 3 et 
4 se component de la meme fagon malgre la fagon differente de s'exprimer. 

INPUT A% 

INPUT "TYPE AGE THEN COMMA THEN NAME": B, C$ 
dans le premier exemple, INPUT imprime un point d'interrogation, et attend que I'utilisateur tape 
un numero, qui sera assigne a la variable entiere A%. Dans le deuxieme exemple, INPUT 
imprime la chaine optionnelle exactement comme elle est vue puis attend que I'utilisateur tape 
un numero (qui sera assigne a la variable reelle B) puis une virgule, puis I'entree chaine (qui 
sera assignee a la variable chaine C$. Des entrees multiples pour INPUT peuvent etre 
separees par des virgules ou des returns. 

INT (NUM) 

fournit rentier le plus grand inferieur ou egal a I'argument donne. Dans I'exemple si NUM est 
2.389, on obtiendra 2; si NUM est -45.123345, on obtiendra -46. 

INVERSE 

Commute le mode video de fagon que les signaux provenant de I'ordinateur s'impriment en 
lettres noires sur fond blanc. Utilisez NORMAL pour revenir aux lettres blanches sur fond noir. 

IN#4 

Specifie le slot (de 1 a 7) du peripherique qui fournira I'entree suivante pour I'ordinateur. In #0 
retablit I'entree en provenance du clavier au lieu du peripherique. 

LEFT $ ("APPLESOFT" 5) 
donne le nombre specifie de caracteres les plus a gauche dans la chaine. Dans I'exemple on 
aura APPLE (les cinq caracteres les plus a gauche). 

Fleche a gauche 
voir touches a fleche 

LEN ("AN APPLE DAY") 
fournit le nombre de caracteres d une chaine entre et 255. Dans I'exemple on obtiendra 14. 

LET A = 23.567 
A$= "DELICIOUS" 

le nom de la variable qui se trouve a gauche de = est assignee a la valeur de la chaine ou .a 
I'expression qui se trouve a la droite de =. Le LET est optionnel. 

LIST 

LIST 200 - 3000 
LIST 200, 3000 

Le premier exemple amene la totalite du programme a etre affichee sur l'ecran TV; le second 
exemple amene les lignes du programme 200 a 3000 a etre affichees. Pour obtenir I'affichage 
du debut du programme jusqu'a la ligne 200, utilisez LIST -200; pour obtenir I'affichage de la 
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ligne 200 a la fin du programme, utilisez LIST 200-. Le troisieme exemple donne le meme 
resultat que le second. L'instruction LIST est annulee par Ctrl C. 

LOAD 

lit un programme APPLESOFT sur bande cassette pour I'enregistrer dans la memoire de 
I'ordinateur. II n'est pas fourni de caracteres indicateurs: I'utilisateur doit rembobiner la bande et 
enfoncer "play" sur le lecteur de cassette avant I'execution LOAD. On entend un bip lorsque 
I'information est trouvee sur la bande a charger. Lorsque le chargement a ete correctement 
execute, on entend un second bip et on obtient le caractere h) de APPLESOFT. Un reset peut 
seul interrompre une instruction LOAD. 

LOG (2) 

donne le logarithme naturel de I'expression arithmetique specifiee. Dans I'exemple on obtient 
.69314 7181. 

LOMEM: 2060 

positionne I'adresse de I'emplacement de memoire le plus faible disponible pour un programme 
BASIC. Ceci permet de proteger les variables provenant des graphiques haute resolution dans 
les ordinateurs a grande capacite de memoire. 

MID $ ("AN APPLE A DAY", 4) 

MID $ ("AN APPLE A DAY", 4,9) 
donne la sous-chaTne specifiee. Dans le premier exemple on obtiendra du 4e au dernier 
caractere de la chaine: APPLE A DAY. Dans le second exemple on obtiendra les 9 caracteres 
qui commencent au 4e caractere de la chame: APPLE A D. 

NEW 

efface le programme en cours et toutes les variables. 
NEXT 

voir la discussion de FOR . . . TO . . . STEP. 
NORMAL 

Commute le mode video pour donner les lettres blanches habituelles sur fond noir a la fois pour 
les signaux d'entree et de sortie. 

NOTRACE 

met hors-circuit le mode TRACE. Voir TRACE. 

ON ID GOSUB 100, 200,23,4005,500 
execute un GOSUB pour rejoindre le n' de ligne indique par la valeur de I'expression 
arithmetique qui suit ON. Dans I'exemple si ID est un, c'est GOSUB 100 qui est execute; si ID 
est 2, c'est GOSUB 200 qui est execute et ainsi de suite. Si la valeur de I'expression est ou 
est superieur au nombre du numero de ligne variantes de la liste, I'execution du programme 
passe a l'instruction suivante. 

ON ID GOTO 100, 200, 23, 4005, 500 
Identique a ON ID GOSOB (voir ci-dessus) mais execute un GOTO branchement au numero de 
ligne indique par la valeur de I'expression arithmetique qui suit ON. 

ONERR GOTO 500 

utilise pour eviter un message d'erreur qui arrete I'execution lorsqu'une erreur se produit. Lors 
de son execution, ONERR GOTO positionne un flag qui cause un saut inconditionnel sur le 
numero de ligne indique (500 dans I'exemple) si une erreur se rencontre par la suite. 

PDL (3) 
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donne la valeur en cours, un nombre entre et 255, de la commande de jeu indiquee. Les 
numeros de commande de jeu a 3 sont valides. 

PEEK (37) 

fournit les contenus, en decimales, de I'octet qui se trouve a I'adresse decimale specifiee (37 
par exemple). 

PLOT 10, 20 

en mode graphique basse resolution, place un point a I'emplacement specifie. Dans I'exemple le 
point sera en X = 10, Y = 20. La couleur du point est determined par la valeur la plus recente de 
COLOR, qui est (noir) si aucune valeur n'a ete specifiee precedemment. 

POKE -16302, 

enregistre I'equivalent binaire du second argument (0 dans I'exemple) dans I'emplacement de 
memoire dont I'adresse decimale est donnee par le premier argument (-16302 dans I'exemple) 

POP 

enframe I'elimination de la derniere adresse de retour de l'instruction RETURN. Le prochain 
RETURN que Ton rencontrera apres un POP effectuera un branchement sur une instruction qui 
se trouve au-dela du second GOSUB execute en dernier lieu. 

POS (O) 

donne la position horizontale en cours du curseur. C'est un nombre allant de (sur la marge 
gauche) a 39 (sur la marge droite). Ce que vous mettez dans les parentheses n'a pas 
d'importance pour autant qu'il puisse etre evalue par APPLESOFT. - 

PRINT 

PRINT A$; "X = " ; X 

le premier exemple amene I'impression d'une ligne et un retour du chariot sur I'ecran. Les items 
d'une liste a afficher dorent etre separes par des virgules si chacun doit etre affiche dans un 
champ distinct du tabulateur. Les items doivent etre separes par des points et virgules s'ils 
doivent etre imprimes immediatement a droite I'un de I'autre sans aucun espace blanc 
intermediate. Si A$ contient "COKE" et si X vaut 3, le second exemple donne I'affichage de 
COREX = 3 

PR#2 

Transfere les signaux de sortie au slot specifie, de 1 a 7. PR#0 renvoie les signaux de sortie 
vers I'ecran TV. 

READ A,B%, C$ 

I'execution de cette instruction assigne aux variables de l'instruction READ les valeurs 
successives des elements qui se trouvent dans les instructions DATA du programme. Dans 
I'exemple, les deux premiers elements des instructions DATA doivent etre des nombres et le 
troisieme doit etre une chaire (qui peut etre un nom). lis seront assignes respectivement aux 
variables A,B% et C$. 

RECALL MX 

rappelle un tableau de reels ou d'entier s qui a ete enregistre sur une bande cassette. Un 
tableau peut etre rappele par un nom different de celui utilise lorsqu'on I'a enregistre sur la 
bande. Si on le rappelle, MX doit avoir ete dimensionne par le programme. Les indices ne sont 
as utilises par STORE ou RECALL. Dans I'exemple c'est le tableau dont les elements sont MX 
(0), MX(1), ... qui sera rappele; la variable non indicee MX ne sera pas affectee. Aucun signal 
souffleur ou autre n'est fourni: vous devez enfoncer la touche 'play' sur le lecteur de cassette 
pour executer l'instruction RECALL; un bip signale le debut et la fin du tableau enregistre. Un 
reset peut seul interrompre un RECALL. 

REM THIS A REMARK 
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permet d'inserer un texte dans un programme sous forme de remarque . ... , 

repeat si vous maintenez enfoncee la touche repeat, indiquee REPT, tout en enfongant une 

touche de caractere quelconque, ce caractere sera repete. 

RESTORE 

repositionne le pointeur de la liste de donnees sur le premier element de DATA. Amene la 
prochaine instruction READ rencontree a relire les instructions de DATA, a partir de la premiere. 

RESUME 

a la fin d'une routine de traitement d'erreur (voir ONERR GOTO), amene la reprise du 
programme a I'instruction ou I'erreur s'est produite. 

RETURN 

effectue un branchement sur I'instruction qui suit immediatement I'instruction GOSUB executee 
le plus recemment. 

RIGHT $ ("SCRAPPLE", 5) 
fournit le nombre specifie de caracteres les plus a droite de la chaTne. Dans I'exemple on 
obtiendra APPLE (les cinq caracteres les plus a droite). 
Fleche a droite (voir touches a fleche) 

RND (S) 

donne un nombre reel aleatoire superieur ou egal a et inferieur a 1 . RND 10) donne le nombre 
aleatoire engendre en dernier lieu. Chaque argument negatif engendre un nombre aleatoire 
particulier qui est le meme chaque fois que Ton utilise RND avec cet argument et les RND 
suivants a arguments positifs vont toujours suivre une sequence particuliere repetitive. Chaque 
fois que Ton utilise RND avec un argument positif quelconque, on engendre un nouveau nombre 
aleatoire entre et 1, a moins qu'il ne fasse partie d'une sequence de nombres aleatoires 
debutee par un argument negatif. 

ROT = 16 

definit un angle de rotation pour la forme a dessiner par DRAW ou XDRAW. ROT = fait que la 
forme doit etre dessinee orientee comme elle a ete definie. ROT = fait que la forme doit etre 
dessinee apres rotation de 90' sens d'horloge, etc . . . Le processus se repete a partir de ROT = 
64. 

RUN 500 

efface toutes les variables les pointeurs et les piles et commence I'execution au numero de ligne 
indique (500 dans I'exemple). Si aucun numero de ligne n'est specifie, I'execution commence au 
numero de ligne le plus faible de programme. 

SAVE 

enregistre un programme sur une bande cassette. Aucun signal indicateur ou autre n'est fourni: 
I'utilisateur doit enfoncer "record" et "play" sur le lecteur de cassette avant d'executer 
I'instruction SAVE. SAVE ne verifie pas que les boutons corrects du lecteur de cassette soient 
enfonces; des bips signalent le debut et la fin de I'enregistrement. 

SCALE = 50 

donne I'echelle pour la forme a dessiner par DRAW ou XDRAW. SCALE = 1 definit une 
reproduction point pour point de la definition de la forme. SCALE = 255 se traduit par le fait que 
chaque vecteur a tracer est agrandi 255 fois. Note: SCALE = est I'echelle maxima et non un 
simple point. 

SCRN (10,20) 

en mode graphique basse resolution, donne le mot couleur du point specifie. Dans I'exemple on 
obtient la couleur du point situe a x = 1 0, y = 20. 
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SGN (NUM) 

donne moins 1 si I'argument est negatif, si I'argument est en 1 si I'argument est positif. 
SHLOAD 

charge un tableau de forme a partir de la bande en cassette. Le tableau de forme est charge 
juste en dessous de HIMEM : puis HIMEM : est place juste sous le tableau de forme pour le 
proteger. 

SIN (2) 

donne le sinus de I'argument, il doit etre en radians. Dans I'exemple, on obtient 909297427. 
SPC (8) - 

doit s'utiliser dans une instruction PRINT. Introduit le nombre specifie d'espaces blancs (8 dans 
I'exemple), entre le dernier item affiche et le suivant. Si des points et virgules precedent et 
suivent I'instruction SPC. 

SPEED = 50 

definit la vitesse a laquelle les caracteres doivent etre envoyees a I'ecran ou autres dispositifs 
d'entree/sortie. La vitesse la plus faible est 0; la plus rapide est 255. 

SQR (2) 

donne la racine carree positive de I'argument; dans I'exemple on obtient 1.414 21356. SQR 
execute plus rapidement que A .5. 

STOP 

amene un programme a cesser son execution et affiche un message indiquant quel numero de 
ligne contenait I'instruction STOP. Le controle de I'ordinateur est renvoye a I'utilisateur. 

STORE MX 

enregistre un tableau d'entiers ou de reels sur bande. Aucun message indicateur ou autre n'est 
fourni: I'utilisateur doit enfoncer "record" et "play" sur le lecteur enregistreur de cassettes pour 
executer I'instruction STORE. Des bips signalent le debut et la fin de I'enregistrement de la fin. 
L'indice du tableau 

n'est pas indique lorsqu'on utilise I'instruction STORE. Dans I'exemple les elements MX (0), 
MX(1), MX(2), . . . sont sauvegardes par enregistrement sur bande; la variable MX n'est pas 
affectee. Voir RECALL. 

STR $ (12.45) 

fournit une chaTne qui represente la valeur de I'argument. Dans I'exemple on obtient la chaTne ' 
12.45'. 

TAB (23) 

doit s'utiliser dans une instruction PRINT. L'argument doit etre entre et 255 et mis entre 
parentheses. Pour les arguments de 1 a 255, si I'argument est superieur a la valeur de la 
position en cours du curseur, alors I'instruction TAB deplace le curseur pour I'amener a la 
position d'affichage specifiee, en comptant a partir du bord gauche de la ligne en cours du 
curseur. Si I'argument est inferieur a la valeur de la position en cours du curseur, alors le 
curseur ne se deplace pas. TAB (0) amene le curseur en position 256. 

TAN (2) 

donne la tangente de I'argument qui doit etre en radians. Dans I'exemple on obtient - 
2.18503987. 

TEXT 

commute I'ecran sur le mode usuel texte non graphique, avec 40 caracteres par ligne et 24 
lignes. Repositionne egalement la fenetre de texte sur la totalite de I'ecran. 
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TRACE 

amene le n° de ligne de chaque instruction a etre affiche sur I'ecran au moment de son 
execution. TRACE n'est pas annule par RUN, CLEAR, NEW DEAL ou reset, mais par 
NOTRACE. 

USR (3) 

cette fonction envoie son argument dans un sous programme de langage machine. L'argument 
est evalue et place dans I'accumulateur a point decimal flottant (emplacements $9D a $A3) et il 
s'etablit un SSR renvoyant a I'emplacement SDA. Les emplacements SOA a SOC doivent 
contenir un INP renvoyant a I'emplacement de debut du sous-programme de langage machine. 
La valeur obtenue pour la fonction est placee dans I'accumulateur a point maximal flottant. Pour 
revenir a APPLESOFT, executez un RTS. 

VAL("-3.7E4A5PLE") 

s'efforce d interpreter une chame, jusqu'au premier caractere non-numerique, comme un reel ou 
un entier et fournit la valeur de ce nombre. Si aucun nombre n'apparait avant le premier 
caractere non-numerique, on obtient un 0. Dans I'exemple on obtient -37000. 

VLIN 10, 20 AT 30 

dans le mode graphique basse resolution, tire une droite verticale dans la couleur indiquee par 
la plus recente instruction COLOR. La droite est tiree dans la colonne indiquee par le troisieme 
argument. Dans I'exemple la droite est tiree de y = 10 a y = 20 pour x = 30. 

VTAB (15) 

deplace le curseur a la ligne de I'ecran specifiee par l'argument. La ligne de tete est la ligne 1 ; la 
ligne inferieure est la ligne 24; VTAB va deplacer le curseur vers le haut ou vers le bas mais non 
vers la gauche ou vers la droite. 

WAIT 16000, 255 
WAIT 16000, 255,0 

permet d'inserer dans le programme une pause conditionnelle. Le premier argument est 
I'adresse decimale de I'emplacement en memoire a tester pour voir si certains bits ont la valeur 
1 et certains bits ont la valeur 0. Chaque bit de I'equivalent binaire du second argument decimal 
indique si vous etes ou non interesse au bit correspondant a I'emplacement en memoire: la 
valeur 1 signifie que vous etes interesse, la valeur signifie que vous devez ignorer ce bit. 
Chaque bit de I'equivalent binaire du troisieme argument decimal indique quel etat vous 
attendez (WAIT) pour le bit correspondant a I'emplacement en memoire: la valeur 1 signifie que 
le bit doit avoir la valeur 0, la valeur signifie que le bit doit avoir la valeur 1 . S'il n'y a pas de 
troisieme argument, on suppose la valeur 0. Si I'un quelconque des bits indiques par un bit de 
valeur 1, dans le second argument correspondent a I'etat pour ce bit indique par le bit 
correspondant du troisieme argument, I'instruction WAIT est terminee. 

XDRAW 3 AT 180, 120 

dessine la forme definie de N' 3 a partir d'un tableau de formes precedemment charge, en 
graphiques haute resolution, en commengant au point x = 180, y = 120. Pour chaque point 
trace, la couleur est le complement de la couleur qui existe defia en ce point. Fournit un moyen 
facile pour effacer: si vous appliquez I'instruction XDRAW a une forme, puis encore une fois, 
vous effacerez la forme sans effacer le fond. 
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Fonctions arc secante 93-94 
Fonctions arc sinus 93-94 
Operateurs arithrretiques 29, 31-32 
tableaux 13, 16, 28, 50 

Allocation en memoire 130 

Carte de la memoire 115-116 

STORE, RECALL 53-56 

Pour econorriser de I'espace 1O7-106 

Page zero 128, 129 
Tousafleche47-48, 10O-1O3, 139 
ASC 39, 51-52 

Codes des caracleres ASCII 126 
Assertions 

Instructions cfassignation 8 
Astensque2, 94 

AT. 5, 6, 22-23, 75-76, 88, 140, 142, 144 
A.T.N. 1617, 92, 112, 139 
avar29, 30, 133 



Pour charger le BASIC 96-99 
Brancherrent 

...GOSUB 14, 15, 63-69, 141-142 
...GOTO 66, 141-142 
Boudes... 10-13, 67-69 



CALL 38, 45-46, 119, 122, 139 
Cassette 

Tableaux 53-56 

Tableaux de formes 87 

Pour charger APPLESOFT 96, 98 

Etendue de la memoire 107 
Pour changer une ligne du prograrrme 47-48, 1CO- 
1C3 

Caractere 7, 26 

Codes ASCI I 126, 127 

Chafne 17-19, 52-53 
CHR$ 51-52, 139 
CLEAR 7, 45^16, 139 
Deux points 

DATA59-6Q 

GET59-60 

INPUT 60 

COLOR 5, 10-11, 21-23, 75, 139 
Couleurs 21-24, 75, 77, 120-122 
Colomes : warcharrps detabulateur 
VirgJes 

DATA60 

GET60 

INPUT 58 

PRINT 5-6, 61 
Instructions 2, 111-112 
Concatenation 

Pourconvertiren APPLESOFT 113 

PRINT 62 

SPC 45-46 

Chafnes 19, 62 
COMT 35, 36, 59, 140 
Code des caracleres de corrrrande 117 
Control B9&98 

Control C 7, 9, 30, 35, 36, 97-99, 140 

DATA 60 

GET 59 

INPUT 58 

UST42 
Control H 59 
Control M 58, 60-61 
Control X 48, 58, 60-61, 140 
Pour conx/ertir en APPLESOFT 113-114 
Fonction cosecante 93 
COS 16-17, 92, 140 
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Fonction cotangente 93 
Ctrl (Control) 30, 133 

Position duarear 44-46, 47-48, 10O-1O3, 126 
Clavier 119 

Codes de nxte-des 110 



DATA 16, 60-61, 129, 140 
Mode de rrise au point 36 

Etrplacements a droite et a gauche du point 
decimal 16-17, 20 

Valeurs dedrmles nerrplacant les nxte-des 110 
DEF 16-17, 64, 140 
Executicridffleree2, 31-32, 122 
DEL 43, 140 

Boude a retard 24, 37-38, 87 
Effacer3, 34, 43 
Dejirriteur29, 133 

Differences entre APPLESOFT etlnteger Basic 130- 
132 

Chiffres 4, 5, 16-17, 20 

Norrbres reels 27-28 
DIM 13, 50, 140-141 
Drrensions voir DIM 
Divisions 2, 16-17, 29, 31-32 
DRAW 82, 87-89 
Variable tactjce 64 



Edtjon 47-48, 10O-1O3 
Element 

Tableaux 13, 28, 50, 53-56 

DATA60-61 
END 15, 35, 107, 140-141 
Signesd'egaliteS, 11-12 
Effacer 

Les progran-mes 3, 34 

L'ecran 4546 

Eireur70-71, 124 

type de code ONERRGOTO 
ESC 30-31 

ESC A B, C, D 47-48, 10O-1O3 

ESC E,F 119 
Execution 2 31-32, 34-40 
EXP 16-17, 93, 140-141 
Exposant4, 5, 16 24-29 
Exponentielle tbnctjon : voir EXP 
expr30-31, 134-135 



Micrcprogran-n-Btjon APPLESOFT 96-99 
Notation a point decimal fixe 4 
Flash 47, 140-141 

Notation a point dedrral flottant4, 109, 129 

FN 64, 140 

Format 4-6, 16-17, 20 

FOR... NEXT 10-13, 18, 67-69, 140-141 

Graphiques sur la totalite de I'ecran 74, 120-122 

Fonction 64, 92-94 

FRE 46-47, 141-142 



CormrBndedejeux78-80, 122-124 
GET 21, 59, 141, 142 

GOSUB... RETURN 14, 15, 68-69, 108, 141-142 
GOTO 7, 66, 70-71, 141-142 

Vitesse du prograrrrne 109 
GR 4, 10-11, 21-23, 74, 120-122, 141-142 
Graphics 4-5, 9-10, 21-24, 73-89 



HCOLOR 23-24, 77, 122, 141-142 

Codes hexadedrraux 127-128 

HGR 22-23, 74, 77, 78 88, 89, 141-142 

HGR2 22-23, 74, 76-77, 7a 89, 141-142 

Graphique haut&resolutjon 22-24, 77-89, 120-122 

Etendue en merroire 115 

Page 129 

HIMEM : 37, 38, 39, 89, 112, 116 127, 142-143 

HUN 5, 22-23, 75-76, 142-143 

HOME 10-11, 42, 45-46, 142-143 

HP LOT 23, 77, 88, 120-122, 142-143 

HTAB 24, 44-45, 142-143 

Foncrjons hypertaoliques 93-94 



IF.. .GOTO 65, 142-143 

IF. ..THEN 8-10, 66, 142 143 

Execution irrmediate 2 31-32 

Pour increments- dans les boudes 12-13, 67-68 

INPUT 7, 8, 58-59, 129, 142-143 

Entree/sortJe 38, 53-64, 115 

CormrBndes de jeux et haut-parieur 78- 

80,122-124 



Pourinserer 

des pauses 37-38 

untexte3, 103 
INI 17-18, 92, 143 
enrjer2, 4 

calculs 31-32 

fbncrJons INT 17-18, 92, 143 

pour arroncir 16-17, 27 

variables 16-17, 27, 134-135 
corrparaison de BASIC et de APPLESOFT 130-132 
routines internes 16-17, 92-93, 108 
pour interrorrpre I'executjon 35-36 
INVERSE 4647, 143 
Foncrjons hypertaoliques inverses 94 
Foncrjons trigonorretriques inverses 92-93 
IN 62, 153 
Iteration 10-13 



LEFT$ 18, 51-52, 113, 143 

touche fleche a gauche 47-48, 59, 100-103, 139 

LEN 17-18, 51, 143 

LET 7, 1117, 63, 143 

lignes 2, 3, 31-32, 107, 129 

lignes en mode graphique 75-76, 77, 82-87 

Affichage dune ligne 60, 119 

NLrrero de ligne 2, 3 30-31, 43, 134-135 

Dimension de I'octet 107 

DATA 60 

GOTO 65 

UST42 

ON...GOTO70-71 

page zero 128 
Iinenum30-31, 134-135 
UST3 4,42, 143 
expression litterale 17, 30, 134-135 

DATA60-61 

INPUT 58 

LET 63 
LOAD 35, 144 
pour charger le BASIC 96-99 
foncrjons logarithmques : voir LOG 
LOG 16-17, 93, 144 
LOMEM 39, 40, 112, 116, 144 

pour effectjjer une boude : voir FOR ...NEXT lO- 
13,18 

graphique basse resolution 74-77 



Sous-prograrrme en langage machine 38, 82-87 
Mantjsse4 

Pour detinir les marges 117, 118 

Pour converrjr les foncrjons MAT en APPLESOFT 

114 

Matrice : voir tableau 



Memoire2, 7, 36, 37 

errplacementdes messages cferreurs 70-71 
HGR 77 
HGR2 76-77 

carte de la merroire 115-116 

Metro re resrante 46-47 

allocation en merroire 106 

page zero 128-129 
metanom26 134-135 
metesyrrtaoles 26, 134-136 
MID$ 18 52-53, 144 

pour converrjr en APPLESOFT 113 
MOD 94 
MODES 

rrise au point 36 

E>«=cutjon36 
Moniteur 

Etendue de la rrarroire 115-116 

Pour revenir au BASIC 97-98 

Tableaux de forme 82-87 

Page zero 128-129 
pour dedacer le curseur 44-48, 100-103, 121 
instructions mJtjples par ligne 9- 10, 114 
mJtjplicatjon 2, 29, 31-32 



name, narre%> narre$ 27, 29, 30, 135 
NEW 

NEXT 10-13, IB, 67-63, 69, 109, 144 
NORMAL 46-47 
NOT 29-32 
NOTRACE 36, 144 
chaTne nulle 17-18 

ASC 51-52 

CATA6&61 

IF ...THEN 66-67 

INPUT 66 

Ml D$ 52-53 
Nurrber4, 5, 16-18, 27-29 
format d'un norrbre4, 5, 16-18, 20, 27-29 



ON ...GOSUB 70-71 

ON ...GOTO 70-71, 144 

ONERRGOTO 70-71, 124, 129, 145 

op30, 135 

OR 29, 31-32 

Output modes video 46-47 
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Pause 24, 37-38, 87 

PDL 78-79, 145 

PEEK 36, 120, 122-124, 145 

Dispositions peripheriques 62-63, 78-79, 115, 
122124 

PLOT 4-5, 9-10, 21, 75, 145 

Plotting 4-5, 9-10, 21-24, 74-89, 120-122 

POKE 37, 42, 117-118, 120-124, 145 

Graphiques sur la totalite de I'eoan 7477, 78, 

120-122 

Pointeurs 34, 45-46, 60-61, 69, 115116, 128-129 
POP 69, 145 
POS 44-45, 145 

Ordre de preseance des operateurs 31-32 
prograrrrne2 

Pointeurs de page zero 128-129 
PRI NTT 2, 5-7, 61-62, 145 

Chaines 1S-19 

TAB 44-45 

SPC 45-46 
Caracteres souffleurs 30-31, 74, 96, 98 
PR#63, 146 



Point cfinterrogation (?) 

INPUT 6, 58-59 

PRINT 61 
Guillerrets 

DATA 60-61 

INPUT 58 

chaines 17-18, 30 



Fonction norrbre aleatoire wir RND 
READ 16, 60-61, 129, 146 
norrbre reel 4, 5, 27-29 

calculs 16-17, 31-32 

DATA60-61 

norrs de \yariables 16-17, 29 
RECALL 53-56, 146 
Relations entre les expressions 8, 31-32 
REM 7, 9-10, 44, 107, 146 
touche de repetition (REFT) 48, 101-103, 146 
pour rerrplacer les lignes 3 
rrots reserves 7, 34, 55-56, 77, 137 

liste 111-112 

allocation en merroire 108 
Reset 30-31, 35-36 
HI MEM : 38-39 
LOMEM : 39 
RECALL 55-56 



RESUME 71 

pour arreter un prograrrrre 35 
STORE 55-56 
RESTORE 55-56 
RESTORE 16, 61, 146 
RESUME 71, 146 

RETURN (touche RETURN) 2, 3, 7, 30-31 

GET60 

INPUT 58-59 

PRINT 61 
RETURN 14-15, 68-69, 146 
RIGHT$ 18, 52-53, 146 
RIGHT$ 

Touche fleche a droite 47-48, 100-103, 139 
RND 16-17, 24, 92, 129, 146 
ROM-APPLESOFT 96-99 
ROT 82, 87-89, 146 
Pourarroncir4, 5, 16-18, 27-29 
RUN 2, 7, 34-35, 146 



SAVE 34, 146 

Pour econorriser de I'espace dans le prograrrrre 
107-108 

SCALE 82, 87-89, 146 
Notation sdentifique 4, 5 
SCRN 77, 146 
Secante93 
sexpr 31-32, 137 
Point etvingule 

INPUT 58-59 

PRINT 6, 61-62 
SGN 92, 146 
formes 82-89 
SHLOAD 82, 87-89, 146 
chiffres significatifs 4, 5 
signe : voir SGN 
SIN 16-17, 92, 146 
Bane oblique inverse 2, 31-32 
Boude30-31 137 
FertesOa7... 62-63 
sop30, 137 
pour trier 14, 21 

les econorriseurs despace 1O7-108 

SPC 44-45-147 

haut-parieur 122-124 

syrrboles spedaux 26 

SPEED 47-48, 147 

pour accelerer le prograrrrre 109 

SQR 10-13, 16-11, 92, 147 

Fonction radne carree, voirSOR 

STEP 12-13, 67-68, 140-141 

STOP 15, 35, 147 

pour arreter un prograrrrre 7, 9-10, 15, 34-35 
Allocation en merroire 106 
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STORE 53-56, 147 
STR$ 19-20, 51, 147 
chaines 1621 30 

ASC 51-52, 139 

CHR$ 51-52, 139 

Ccricatenation 19, 45-46, 62 

pourcorrvertiren APPLESOI=T 113-114 

DATA 60, 61, 140 

IF ...THEN 66, 142-143 

INPUT 58-59, 142-143 

l_EFT$ 18, 51-52, 143 

LEN 17-18, 51, 143 

LET 63, 143 

Merroire 46-47, 108, 115-116, 128-129 

MID$ 18-19, 52-53, 144 

chafne nulles 17-18, 51-53, 59, 60-61 6&67 

RECALL 53-56, 146 

RIGHT$ 18, 52-53, 146 

STORE 53-56, 144 

STR$ 19-20, 51, 147 
Sous-chaine 51-53 
VAL 19, 21 51 147-148 
Sous-prograrrrre 15, 20, 68-69 
indce 13-14, 30, 50 
sous-chaTne 51-53 
svar30, 137-138 
definitions syntaxiques 26-32 
parordre alphabetique 133-138 



USR 40, 147-148 



VAL 19, 21, 51, 147-148 
W3r 30-31 
W3riables 7, 27-31 

tableaux 13, 50 

boudes FOR ...NEXT 11-13, 67-69 

INPUT 7, 8, 58-59, 62 

entier 16-18, 27 

LET (=* 7, 11-13, 63-64 

norrs 7, 13, 16-17, 27-31 

Vitesse du prograrrrre 109 

READ, DATA 16, 60-61 

Reel 16-17 

Pour econorriser de I'espace 107-108 

charne 16-17 

page zero 128-129 
uacteur 82-86 
sortie video 45-47 
VUN 5-6, 22-23, 7576, 147 
VTAB 24, 44, 147 



\AAIT 37-38, 147 

Fenerje 44-45, 61, 74, 117-118 



tabulateur XDRAW82, 87-89, 147-148 

charrps 61-62 XPLOT 131-132 

HTAB 44-45 
TAB 4445, 147 
VTAB 44 

TAN 16-17, 92, 147 Page zero 128-129 

fonctions tangentes (\*»rTAN) 
TEXT 5-6 10-11, 74, 147 
Texle 5-6, 21 

etgraphique 10-11, 120-122, 147 

Etendue en merroire 115 

fenerje 44-45, 61-62, 74, 114-119 
THEN: voir IF. ..THEN 
TO : voir HPLOT et GOTO 

valeurs dedrmles rerrplacant les rrots-des HO 
TRACE 36, 71 147 

fonctions Wgprorretriques 16-17, 92-94 
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